[7] 列挙属性れっきょぞくせいenumerated attributeは、 幾つかの値の候補からいずれかを選んで指定できる属性です。

仕様書

意味

[27] 列挙属性は、キーワードの有限集合のいずれかの値を取ると定義されている属性です >>9。

[8] 列挙属性の属性値となり得る値のことを、キーワードkeywordといいます。

[28] 列挙属性には、いくつかの状態stateが定義されています。

[29] 各キーワード列挙属性には、どの状態列挙属性に対応するかの写像が定義されています。 複数のキーワード列挙属性が1つの状態列挙属性に対応する場合もあります。 >>9

[30] キーワード列挙属性は、不適合とされていることもあります >>9。

[31] 多くの場合、歴史的理由により同じ状態列挙属性を表す複数のキーワード列挙属性が存在しているものです。

[62] 列挙属性の反映に関する処理で、キーワード列挙属性の大文字・小文字の正準形canonical caseが使われることがあります >>56。 「正準形」とは仕様書で示されている大文字と小文字の表記のことと思われますが、 現在規定されているものはすべて小文字となっています。

[32] 列挙属性には、 非妥当値既定値invalid value defaultが定義されていることがあります >>9。

[33] 列挙属性には、 欠値既定値missing value defaultが定義されていることがあります >>9。

[52] これらの値は状態列挙属性です。いずれかのキーワード列挙属性が写像される状態列挙属性のこともあれば、 専用の状態列挙属性のこともあります。 非妥当値既定値と欠値既定値は同じことも多いですが、違うこともあります。

[60] 欠値既定値が定義されていて非妥当値既定値が定義されていない場合、 実質的に欠値既定値と同じものが非妥当値既定値となります。 (明示的に両者が等しいと定義されている場合もあります。)

[53] 非妥当値既定値が定義されていて欠値既定値が定義されていないこともあります。

属性値

[11] 列挙属性の属性値は、 キーワード列挙属性のいずれかと ASCII大文字・小文字不区別で一致しなければなりません >>9。

[34] ただし、不適合とされるキーワード列挙属性であってはなりません >>9。

[35] キーワード列挙属性の前後に空白を挿入することは、 認められていません。

[54] なお、キーワード列挙属性は空文字列となることもあります。

[55] キーワード列挙属性の多くはASCII英数字で構成されていますが、 enctype 属性のように記号が含まれることもあります。 非ASCII文字が現れる列挙属性はありません。

処理

[36] 要素要素の列挙属性名前の状態列挙属性は、 次のようにして得られます >>9。

  1. [37] 要素に名前内容属性が指定されている場合、
    1. [38] 値を、要素の名前属性値に設定します。
    2. [39] 要素の名前属性に値と ASCII大文字・小文字不区別で等しいキーワード列挙属性がある場合、
      1. [40] そのキーワード列挙属性に対応する状態列挙属性を返します。
    3. [43] それ以外で、非妥当値既定値がある場合、
      1. [44] その非妥当値既定値の状態列挙属性を返します。
    4. [41] それ以外で、欠値既定値がある場合、
      1. [42] その欠値既定値の状態列挙属性を返します。
    5. [45] それ以外の場合、
      1. [46] null を返します。
  2. [47] それ以外の場合、
    1. [48] 欠値既定値がある場合、
      1. [49] その欠値既定値の状態列挙属性を返します。
    2. [50] それ以外の場合、
      1. [51] null を返します。

IDL 属性

[57] 多くの列挙属性には、それを反映 >>56 する IDL属性があります。

列挙属性の一覧

[12] 現在の HTML には次の列挙属性があります。

[58] HTML の列挙属性
attr
属性
empty
空文字列
non
不適合キーワード列挙属性
missing
欠値既定値
invalid
非妥当値既定値
idl
IDL属性
attr
as<link as>
idl
既知値のみに限定
attr
autocapitalize
missing
あり
invalid
あり
idl
特殊
attr
autocomplete
missing
あり
invalid
欠値既定値
idl
既知値のみに限定
attr
contenteditable
empty
あり
missing
別
invalid
欠値既定値
idl
特殊
attr
crossorigin
empty
あり
missing
別
invalid
あり
idl
DOMString?nullable
attr
decoding<img decoding>
invalid
欠値既定値
missing
あり
idl
既知値のみに限定
attr
dir
idl
既知値のみに限定
attr
draggable
missing
別
invalid
欠値既定値
idl
特殊
attr
enctype
invalid
あり
missing
あり
idl
既知値のみに限定
attr
formenctype
invalid
あり
#
no missing value default
idl
既知値のみに限定
attr
inputmode
missing
別
invalid
欠値既定値
idl
既知値のみに限定
attr
kind<track kind>
invalid
あり
missing
あり
idl
既知値のみに限定
attr
method
invalid
あり
missing
あり
idl
既知値のみに限定
attr
formmethod
invalid
あり
idl
既知値のみに限定
attr
preload
missing
実装定義
empty
あり
invalid
欠値既定値
idl
既知値のみに限定
attr
referrerpolicy
missing
あり
invalid
あり
empty
あり
idl
既知値のみに限定
attr
scope
missing
別
invalid
欠値既定値
idl
既知値のみに限定
attr
shape
non
あり
missing
あり
invalid
欠値既定値
idl
DOMString
attr
spellcheck
missing
別
empty
あり
invalid
欠値既定値
idl
特殊
attr
translate
missing
別
empty
あり
invalid
欠値既定値
idl
特殊
attr
type<button type> (button)
missing
あり
invalid
欠値既定値
idl
既知値のみに限定
attr
type<input type> (input)
missing
あり
invalid
欠値既定値
idl
既知値のみに限定
attr
updateviacache
missing
あり
invalid
あり
idl
既知値のみに限定
attr
workertype
missing
あり
invalid
別
idl
既知値のみに限定
attr
wrap
missing
あり
non
あり
invalid
欠値既定値
idl
DOMString
attr
behavior
non
すべて
missing
あり
invalid
欠値既定値
idl
DOMString
attr
direction
non
すべて
missing
あり
invalid
欠値既定値
idl
DOMString

[25] 次の属性は、列挙属性ですが、仕様書上は状態と値を直接規定する通常の方法ではなく、 他の定義を参照する形となっています。 (仕様書の定義上は特別ですが、 利用上は特別な所はありません。)

[61] wrap 属性は、どのキーワード列挙属性とも異なる (不適合の) 値 offwrap がレンダリング上意味を持つことになっています。 (列挙属性としては非妥当値既定値 (がないので欠値既定値) が選択されていることになりますが、 他の値の場合と挙動が異なります。)

[63] preloadpreload="" 属性の欠値既定値は、 利用者エージェント依存とされています。ただし推奨される値は規定されています。

[13] 廃止された属性にも、列挙属性だったものが少なくありませんでした。 廃止された属性の一部 (例えば align 属性) は現在もWebブラウザーのレンダリング時には参照されることになっていますが、 仕様書上は利用者エージェントスタイルシートとして記述されており、 形式的には列挙属性とされていません。

[64] かつての keygen 要素の keytype 属性は、欠値既定値が利用者エージェント依存とされていました。

[65] かつての menu 要素の type<menu type> 属性は、欠値既定値が親要素依存とされていました。 (親要素次第でどこまでも祖先方向に遡っていくことがありました。)

[19] <ol type>は、列挙属性に近いですが、 大文字と小文字を区別します。

[22] 廃止された <li type> と <dir type> は、列挙属性である <ul type> と大文字・小文字を区別する <ol type> の両方の属性値を指定できることになっていました。

[21] autocomplete は、かつては列挙属性でしたが、 その後の拡張で独自の構文となりました。

[20] <link as> は、列挙属性に近いですが、 大文字と小文字を区別します。反映するIDL属性は Web IDLの列挙型 RequestDestination として定義されています。

歴史

列挙型 (SGML)

[1] WebSGML では同じ要素型の複数の列挙型の属性で、選択肢として同じ名前字句が含まれていてもかまいません。

例 : (素の SGML では不当、 Web SGML では妥当)

<!ATTLIST block
   align (left|center|right) #IMPLIED
  valign (top|center|bottom) #IMPLIED>

しかしながら、この場合、重複した値が使われる属性指定では属性名の省略ができなくなります。 (K.4.4.2 参照。) 例 :

90年代の HTML

[10] HTML の列挙属性は SGML の列挙型の属性に遡ります。 HTML4 までの HTML 仕様は SGML DTD を使って記述されていましたので、 SGML で属性型が列挙型で規定されているものが列挙属性とされていました。 それらは後に XHTML でも XML DTD 上で列挙型として記述されました。

Web Forms 2.0

[2] Web Forms 2.0 では、いくつかの属性が、 決められた値のうちのいずれかを取ると定義されていました。 従来の版の HTML では列挙型の属性やブール型属性と呼ばれていたものがそれにふくまれました。

  • [3] Web Forms 2.0
    • 2.3. Changes to existing controls http://www.whatwg.org/specs/web-forms/current-work/#changes

[4] 大文字と小文字: 属性値の比較は、大文字・小文字不区別で行います。 WF2 2.3

[5] 空白: Web Forms 2.0 では、 HTML 4 の定義とは異なり、 空白の削除はしてはなりません。 WF2 2.3

但し、使用している DTD によっては、 XML の規則に従い、 HTML レベルの処理以前に属性値の空白の正規化が行われているかもしれません。

[6] 従って、 HTML文書

<input type=" text ">
は不適合です。

HTML5

[59] contenteditable は空文字列もキーワードである点で HTML5 より前の列挙属性の定義には合致しませんでした。 method や formmethod も「/」がキーワードに含まれているため HTML5 より前の列挙属性の定義には合致しませんでした。

[14] [whatwg] IDL attribute reflecting enumerated attributes not limited to only know values ( 版) http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2010-August/027697.html

[15] [whatwg] IDL attribute reflecting enumerated attributes not limited to only know values ( ( 版)) http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2010-August/028201.html

[16] Web Applications 1.0 r5537 Match UAs better for 'limited to known values' reflection.Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=10380 ( ( 版)) http://html5.org/tools/web-apps-tracker?from=5536&to=5537

[17] XBL 2.0 ( ( 版)) http://dev.w3.org/2006/xbl2/Overview.html#attributes-containing-keywords

[18] XML Binding Language (XBL) 2.0 ( ( 版)) http://www.w3.org/TR/2007/CR-xbl-20070316/#state

[23] Case-sensitive as="" for <link> is weird · Issue #1665 · whatwg/html () https://github.com/whatwg/html/issues/1665

[24] Do not repeat the referrer policies (domenic著, ) https://github.com/whatwg/html/commit/4c228d3fd9e61dee2c45ee0cd7722e1671f6ca9f

[26] Make <link>'s as="" attribute case-insensitive (domenic著, ) https://github.com/whatwg/html/commit/9c7da4998f005c1799b04f452cb6c4a618f2d42e

[66] Limit crossOrigin reflection to only known values (ayg著, ) https://github.com/whatwg/html/commit/d967dc0120c137d0eb22808d4eaac0726cd8ea78

[67] Editorial: always state invalid value default (GloverDonovan著, ) https://github.com/whatwg/html/commit/7e941ae96b264d4743ea0afac00c3b3209ab0cde

[68] Be explicit about missing value default & invalid value default · Issue #173 · whatwg/html () https://github.com/whatwg/html/issues/173

[69] Be explicit about missing value default and invalid value default by GloverDonovan · Pull Request #3526 · whatwg/html () https://github.com/whatwg/html/pull/3526

[70] Do not allow http-equiv values curated via wiki (domenic著, ) https://github.com/whatwg/html/commit/72d084b81fa94915518b9cf279afef87d835e88e