Edit

Page

Page title:

Page body:

[51] [DFN[[RUBY[属性][ぞくせい]@en[attribute]]]]は、
[[要素]]に関する付加情報を記述するものです。

[52] [[属性]]は、[F[属性名]]と[F[属性値]]の組です。[[要素]]にはいくつでも[[属性]]を指定できますが、
同じ[F[属性名]]のものは1つしか指定できません。
つまり[[要素]]の[F[属性リスト]]は[[要素]]ごとの[[写像]]と捉えることができます。

[53] 具体的にどのような[F[属性名]]と[F[属性値]]を指定できるのかは、[[要素]]の[[種類][要素型]]や文脈によって異なります。

* 仕様書

[REFS[
- [11] [CITE@en[DOM Standard]] ([TIME[2016-02-20 20:19:45 +09:00]] 版) <https://dom.spec.whatwg.org/#element>
- [39] [CITE@en-GB-x-hixie[HTML Standard]] ([TIME[2016-05-14 09:55:50 +09:00]]) <https://html.spec.whatwg.org/#semantics-2>
]REFS]

* 意味

[40] [[著者]]は、[[属性]]や[[属性値]]を、その想定用途以外の目的で使っては[MUST[なりません]]
[SRC[>>39]]。これは、[[文書]]を正しく処理できるようにするための要件です [SRC[>>39]]。

* 文脈

[38] [[著者]]は、[[属性]]や[[属性値]]を、[[適用可能な仕様書]]で認められていないのに使っては[MUST[なりません]] [SRC[>>39]]。
これは、[[言語]]の将来の拡張の余地を残すためです [SRC[>>39]]。

[42] どのような[[属性]]を使って良いかは、[[要素]]ごとに決められています。

;; 各[[要素]]の項を参照。

[43] いくつかの[[属性]]は、多数の[[要素]]で共通して使うことができます。
そうした[[属性]]を、次のように分類しています。
[FIG(short list)[
- [[超大域属性]]
- [[大域属性]]

[HISTORY[
- [[共通属性]]
]HISTORY]
]FIG]

[44] なお、同じ[[属性名]]であっても、[[要素]]によって異なる意味を持つことがあります。

[45] ほとんどの[[要素]]は、特定の[[属性]]のみを認め、それ以外を禁止しています。
例外的に、次の[[要素]]は、 (一定の制約の元で) [[著者]]が任意の[[名前][属性名]]の[[属性]]を使うことを認めています。
[FIG(short list)[
- [CODE(HTMLe)@en[embed]]
- [[自律カスタム要素]]
]FIG]
この他に、 [CODE(HTMLa)@en[data-[VAR[*]]]] [[属性]]を多くの[[要素]]で使えます。

* [CODE(DOMi)@en[Attr]] インターフェイス (DOM)

[13] [[DOM1]] で[RUBYB[属性節] [[CODE(DOM)[Attr]] node]]が持つことが出来る子[[節]]の種類は、
[[Text]] と [[EntityReference]] の2種類です。

[14] [[DOM]] の文書木・節モデルの中では、[[属性]]はやや特殊な位置づけになっています。
- [CODE(DOM)[Attr]] 節は、文書木の中には現れません。
- 親節・兄弟節はありません。 (取出す method の結果は [CODE(DOM)[null]]。)
- [[DTD]] で既定値が宣言されている場合には、その要素の属性値が明示されていない場合に常にその既定値が設定されていることとなります。
- [CODE(DOM)[[[DocumentFragment]]]] 節の直接の子要素にはできません。
- [CODE(DOMattr)[[[nodeValue]]]] では属性値文字列が、 [CODE(DOMa)[[[childNodes]]]] では [CODE(DOM)[[[Text]]]] 節及び [CODE(DOM)[[[EntityReference]]]] 節の組合せによる属性値の表現が得られます。

[15] [CODE(DOMi)[[[Node]]]] を継承して、
,読取専用属性	,[CODE(DOMa)[[[name]]]]	,名前	,[DOM1]
,読取専用属性	,[CODE(DOMa)[[[specified]]]]	,指定されているか	,[DOM1]
,属性	,[CODE(DOMa)[[[value]]]]	,値	,[DOM1]
,読取専用属性	,[CODE(DOMa)[[[ownerElement]]]]	,親要素節	,[DOM2]

- [DOM1] ''Document Object Model (Core) Level 1'' <http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#ID-637646024>
- [DOM2] ''Document Object Model Core'' <http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-637646024>
- [4] 親節になれるのは [CODE(DOM)[[[Element]]]] 節だけです。
- [5] DOM 1 は、属性の型は分からないかもしれないから字句化値を扱う機能は提供しないといっています。ですから、例えば [CODE(XML)[IDREFS]] 型属性値の3番目の [CODE(XML)[ID]] を取り出したい、という場合には、属性値全体を受け取ってそれを勝手に解析する必要があります。

[16] [CODE(DOMi)[Attr]] 節点の子孫である [CODE(DOMi)[[[EntityReference]]]] 節点の子供は
[CODE(DOMi)[[[EntityReference]]]] または
[CODE(DOMi)[[[Text]]]] しか認められない・・・はずですが、
[[DOM]] の仕様書にはそんなこと一言も書いてないな。

[17] [[DOM]] の仕様書には [CODE(DOMi)@en[[[Attr]]]]
は他の種類の [CODE(DOMi)@en[[[Node]]]] とは違って
[CODE(DOMi)@en[[[Element]]]] と切り離せないものだとかなんとか説明がありますが、
それでいてなぜか [CODE(DOMi)@en[[[Attr]]]]
が単独で存在できたりします。
それ自体は値を持たずに[[子孫]]がいたり。

[18] 
[PRE[
Interface AttrExtended
  IDL Definition
    attribute boolean type;
  Attributes
    isClassAttribute of type boolean
      Whether the attribute is a class attribute or not.
      If it is a class attribute, the value is "true"; otherwise, "false".
      Note that not all attributes whose local name is "class"
      is a class attribute.
]PRE]

[19] [[Chrome]] は [[DOM3]] の規定通り [CODE(DOMi)@en[[[Attr]]]] の[[子供]]に [CODE(DOMi)@en[[[Text]]]]
が来る構造になっていて、通常の [CODE(DOMi)@en[[[Node]]]] として操作できます。
しかし [[WinIE]] や [[Gecko]] は [[DOM4]] の規定のように [CODE(DOMi)@en[[[Attr]]]]
の値を[[節点]]としては扱っていません。 [CODE(DOMa)@en[[[childNodes]]]] は空ですし、
[CODE(DOMm)@en[[[appendChild]]]] は [CODE(DOMe)@en[[[HierarchyRequestError]]]] になります。
[TIME[2012-12-15T13:41:44.200Z]]

[20] [CITE[IRC logs: freenode / #whatwg / 20121213]]
( ([TIME[2012-12-17 21:09:20 +09:00]] 版))
<http://krijnhoetmer.nl/irc-logs/whatwg/20121213#l-339>

[21] [CITE@en[Re: ''''''[''''''DOMCore'''''']'''''' Attr]]
( ([[Jonas Sicking]] 著, [TIME[2010-09-11 01:28:14 +09:00]] 版))
<http://lists.w3.org/Archives/Public/public-webapps/2010JulSep/0797.html>

[22] [CITE@en-US[Attr - Document Object Model (DOM) | MDN]]
( ([TIME[2012-09-30 03:37:57 +09:00]] 版))
<https://developer.mozilla.org/en/docs/DOM/Attr>

* 属性の変化

[36] [[要素]]の[[属性]]が変化した時の[[要素]]・[[属性]]依存の動作を記述するためのフックが
[[DOM Standard]] で[DFN[[RUBYB[属性変更手順群]@en[attribute change steps]]]]として定義されています。 [SRC[>>11]]。

[37] 次のものに関する[[属性変更手順群]]が定義されています。
[FIG(short list)[
- [CODE(DOMi)@en[DOMTokenList]]
- [CODE(HTMLe)@en[slot]]
- [[スロット可能]]
- [[カスタム要素反応]]
]FIG]

[29] [[仕様書]]上ではこのフックを使っていませんが、[[属性]]が変化した時に次のような処理が連動して行われます。
[FIG(list middle)[
- [CODE(HTML)@en[<base href>]]
- [CODE(HTMLe)@en[[[iframe]]]]
- [CODE(HTMLe)@en[[[iframe]]]] [CODE(HTMLa)@en[[[name]]]]
- [CODE(HTMLe)@en[[[iframe]]]] [CODE(HTMLa)@en[[[sandbox]]]]
- [CODE(HTMLe)@en[[[iframe]]]] [CODE(HTMLa)@en[[[allowfullscreen]]]]
- [CODE(HTMLe)@en[[[frame]]]] [CODE(HTMLa)@en[[[name]]]]
- [CODE(HTMLe)@en[[[embed]]]]
- [CODE(HTMLe)@en[[[object]]]]
- [CODE(HTMLe)@en[[[param]]]]
- [CODE(HTMLa)@en[[[accesskey]]]]
- [CODE(HTMLe)@en[[[<script async>]]]]
- [CODE(HTMLe)@en[[[<script src>]]]]
- [CODE(HTMLe)@en[meta]]
- [CODE(HTMLe)@en[link]]
- [[イベントハンドラー内容属性]]
- [CODE[NoncedElement]]
]FIG]

[46] [[カスタム要素反応]]に関する処理は、[[仕様書]]上は[[属性変更手順群]]ではなく、
[[属性変更手順群]]の直前に実行する処理として規定されています。

[41] [[レンダリングの更新]]も参照。

[HISTORY[
[23] かつては [[DOM Standard]] で4つのフックが定義されていました [SRC[>>11]]。
その後[[属性変更手順群]]に統一されました。

[FIG(list middle)[
- [24] [DFN[[RUBYB[[[属性の設定]]]@en[attribute is set]]]]
- [25] [DFN[[RUBYB[[[属性の追加]]]@en[attribute is added]]]]
- [26] [DFN[[RUBYB[[[属性の変更]]]@en[attribute is changed]]]]
- [27] [DFN[[RUBYB[[[属性の削除]]]@en[attribute is removed]]]]
]FIG]

[28] 設定は追加・変更のどちらかと同時に起こります。

[8] かつては次の[[内容属性]]にも処理が規定されていました。
[FIG(short list)[
- [CODE(XMLa)@en[[[xml:base]]]]
]FIG]
]HISTORY]

* 歴史

** 属性 (SGML)

[1]

>
:(141) (要素の) 属性 [attribute (of an element)]:
[[型]]及び[[内容]]を除く[[特質]]。 [SRC[[[JIS X 4151]]‐1992 3.]]

[2] [[SGML]] では[[要素型]]や[[要素]]の[[内容]]も広い意味では[Q[属性]]に含まれます
[SRC[JIS X 4151‐1992 参考]]。 [[SGML]] [[規格本体]]で特に
[Q[要素の属性]]として定義されているものはそれ以外、
すなわち[[属性指定]]で指定され得る形式的な属性のみを指すべく >>1
のように説明されています。

** 属性 (XML)

[3]

>
:[RUBYB[属性] [attribute]]:
属性は [[DTD]] で宣言される[[要素]]の[[引数]]です。
[[属性]]の[[型]]と[[値域]]、更に場合によっては[[既定値]]は
[[DTD]] で定義されます。

仕様書:
- [[XHTML 1.0]]
-- [CITE[2.2. General Terms]]
<IW:XHTML10:"general">

[7] [CITE[IRC logs: freenode / #whatwg / 20090925]]
([TIME[2009-11-17 00:09:05 +09:00]] 版)
<http://krijnhoetmer.nl/irc-logs/whatwg/20090925#l-298>

** 属性節点 (XPath 1.0 データモデル) / [CODE[attribute::]] ([CODE[@]]) 軸 (XPath 1.0)

@@ XXX

[30] [[Chrome]] でも [[Firefox]] でも、仕様通り [CODE(XML)@en[[[xmlns]]]] [[名前空間]]の[[属性]]は
[[XPath]] データモデル上の[[属性節点]]としては存在しません。 [TIME[2013-10-05T08:24:31.300Z]]

** 属性情報項目 (XML 情報項目)

[6]
[[Atom]] や [[AtomPub]] の仕様書では、「[[属性]]」は[[属性情報項目]]を意味します。

;;[CITE@en[RFC 5023 - The Atom Publishing Protocol]] ([TIME[2008-11-20 18:52:14 +09:00]] 版) <http://tools.ietf.org/html/rfc5023#section-2.1.1>

[31] [CITE@en[Touch Events]]
( ([TIME[2013-10-12 10:35:42 +09:00]] 版))
<https://dvcs.w3.org/hg/webevents/raw-file/v1/touchevents.html#webidl-conform>

[32] [CITE@en[Re: Moving Touch Events v1 to Recommendation]]
( ([[Doug Schepers]] 著, [TIME[2013-10-02 15:26:02 +09:00]] 版))
<http://lists.w3.org/Archives/Public/public-webevents/2013OctDec/0000.html>

[33] [CITE@en-US[Accessible Rich Internet Applications (WAI-ARIA) 1.0]]
( ([TIME[2014-01-14 16:21:51 +09:00]] 版))
<http://www.w3.org/WAI/PF/aria/complete#def_attribute>

[34] [CITE@en[XQuery and XPath Data Model 3.0]]
( ([TIME[2014-04-08 07:00:06 +09:00]] 版))
<http://www.w3.org/TR/xpath-datamodel-3/#AttributeNode>

[35] [CITE@en[Bug 25460 – muted and mediagroup should not be special-cased for the parser]]
( ([TIME[2014-06-06 11:54:47 +09:00]] 版))
<https://www.w3.org/Bugs/Public/show_bug.cgi?id=25460>

[FIG(quote)[
[FIGCAPTION[
[9] [CITE@en-US[OPDS Catalog 1.1]]
([TIME[2015-11-19 00:28:42 +09:00]] 版)
<http://opds-spec.org/specs/opds-catalog-1-1-20110627/>
]FIGCAPTION]

> The Infoset terms "Element Information Item" and "Attribute Information Item" are shortened to "element" and "attribute" respectively. Therefore, when this specification uses the term "element", it is referring to an Element Information Item, and when it uses the term "attribute", it is referring to an Attribute Information Item.

]FIG]

[10] [CITE@en[Fix #489: 'src attribute is missing' is equal to 'no src attribute sp… · whatwg/html@3f7fda0]]
([TIME[2016-01-28 23:24:34 +09:00]] 版)
<https://github.com/whatwg/html/commit/3f7fda0be2759dc36480c8acc037d149ee831aea>

[12] [CITE@en[Use a single concept for attribute changes · whatwg/dom@4b291d1]]
([TIME[2016-04-19 17:08:52 +09:00]] 版)
<https://github.com/whatwg/dom/commit/4b291d1a91a1e8b59997d4b021137d809706bd37>

[47] [CITE@en[Integrate with the Referrer Policy spec, part 1 of n]]
( ([[domenic]]著, [TIME[2016-05-05 23:01:42 +09:00]]))
<https://github.com/whatwg/html/commit/6a7318072f340ad45229df171245d70d8621c2fe>

[48] [CITE@en[Make Attr inherit from Node again]]
([[annevk]]著, [TIME[2016-08-19 21:44:07 +09:00]])
<https://github.com/whatwg/dom/commit/625a0747f137454c155a7b577a9e45be1aa35a34>

[49] [CITE@en[ATTRIBUTE_NODE and SHOW_ATTRIBUTE are no longer historical]]
([[foolip]]著, [TIME[2016-09-01 01:36:31 +09:00]])
<https://github.com/whatwg/dom/commit/dc3990d2678375a17fa05f3f4de99da23077c229>

[50] [CITE@en[Further Attr node fixes for compareDocumentPosition()]]
([[annevk]]著, [TIME[2016-09-01 01:29:21 +09:00]])
<https://github.com/whatwg/dom/commit/0e17e05b7b0273799b853c4782b2eac9a88fdea1>

[54] [CITE@en[Elements with duplicated attributes are not nonceable.]]
([[mikewest]]著, [TIME[2017-11-27 17:28:11 +09:00]])
<https://github.com/w3c/webappsec-csp/commit/649393514b9aaf9277bfd21ee1834f4befd029be>

[55] [CITE@en[Consider hiding `nonce` content attributes. · Issue #2369 · whatwg/html]]
([TIME[2018-02-17 23:20:38 +09:00]])
<https://github.com/whatwg/html/issues/2369>

[FIG(quote)[
[FIGCAPTION[
[56] [CITE@”ja”[【論調比較・サマータイム】日経はシステム改修の問題を詳報 | News Socra (ニュース ソクラ)]]
([TIME[2018-09-06 20:11:40 +09:00]])
<https://socra.net/society/%E3%80%90%E8%AB%96%E8%AA%BF%E6%AF%94%E8%BC%83%E3%83%BB%E3%82%B5%E3%83%9E%E3%83%BC%E3%82%BF%E3%82%A4%E3%83%A0%E3%80%91%E6%97%A5%E7%B5%8C%E3%81%AF%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0%E6%94%B9%E4%BF%AE/>
]FIGCAPTION]

> <html lang=”ja”>

]FIG]

[57] [CITE@en[Editorial: Clarify that attributes and operations may be namespace me…]]
([[littledan]]著, [TIME[2019-03-05 17:24:18 +09:00]])
<https://github.com/heycam/webidl/commit/6b9ad923b1c2ce7d128790dfceb4dda33adb9c89>

[58] [CITE@en[Editorial: embrace that attributes are objects]]
([[annevk]], [TIME[2019-12-12 02:40:19 +09:00]], [TIME[2022-01-27T11:50:16.000Z]])
<https://github.com/whatwg/dom/commit/0038d097f5cad2a7ffdbe75c234b58960aa320f6>

[59] [CITE@en[Editorial: embrace that attributes are objects by annevk · Pull Request #805 · whatwg/dom]]
([TIME[2022-01-27T11:58:04.000Z]])
<https://github.com/whatwg/dom/pull/805>

Historical Legal Sensitive Parent: [Help / License]

Edit

Page

Page name(s)