[7] [DFN[[RUBY[列挙属性][れっきょぞくせい]@en[enumerated attribute]]]]は、 幾つかの値の候補からいずれかを選んで[[指定]]できる[[属性]]です。 * 仕様書 [REFS[ - [9] [CITE@en-US-x-hixie[HTML Standard]] ([TIME[2017-06-16 08:10:52 +09:00]]) - [56] [CITE@en-US-x-hixie[HTML Standard]] ([TIME[2017-06-16 08:10:52 +09:00]]) ]REFS] * 意味 [27] [[列挙属性]]は、[[キーワード]]の[[有限集合]]のいずれかの値を取ると定義されている[[属性]]です [SRC[>>9]]。 -*-*- [8] [[列挙属性]]の[[属性値]]となり得る値のことを、[DFN[[RUBYB[キーワード]@en[keyword]]]]といいます。 [28] [[列挙属性]]には、いくつかの[DFN[[RUBYB[状態]@en[state]]]]が定義されています。 [29] 各[[キーワード][列挙属性]]には、どの[[状態][列挙属性]]に対応するかの[[写像]]が定義されています。 複数の[[キーワード][列挙属性]]が1つの[[状態][列挙属性]]に対応する場合もあります。 [SRC[>>9]] [30] [[キーワード][列挙属性]]は、[[不適合]]とされていることもあります [SRC[>>9]]。 ;; [31] 多くの場合、[[歴史的理由]]により同じ[[状態][列挙属性]]を表す複数の[[キーワード][列挙属性]]が存在しているものです。 [62] [[列挙属性]]の[[反映]]に関する処理で、[[キーワード][列挙属性]]の[RUBYB[[[大文字]]・[[小文字]]の正準形]@en[canonical case]]が使われることがあります [SRC[>>56]]。 「正準形」とは[[仕様書]]で示されている[[大文字]]と[[小文字]]の表記のことと思われますが、 現在規定されているものはすべて[[小文字]]となっています。 -*-*- [32] [[列挙属性]]には、 [DFN[[RUBYB[非妥当値既定値]@en[invalid value default]]]]が定義されていることがあります [SRC[>>9]]。 [33] [[列挙属性]]には、 [DFN[[RUBYB[欠値既定値]@en[missing value default]]]]が定義されていることがあります [SRC[>>9]]。 [52] これらの値は[[状態][列挙属性]]です。いずれかの[[キーワード][列挙属性]]が[[写像]]される[[状態][列挙属性]]のこともあれば、 専用の[[状態][列挙属性]]のこともあります。 [[非妥当値既定値]]と[[欠値既定値]]は同じことも多いですが、違うこともあります。 [60] [[欠値既定値]]が定義されていて[[非妥当値既定値]]が定義されていない場合、 実質的に[[欠値既定値]]と同じものが[[非妥当値既定値]]となります。 (明示的に両者が等しいと定義されている場合もあります。) [53] [[非妥当値既定値]]が定義されていて[[欠値既定値]]が定義されていないこともあります。 * 属性値 [11] [[列挙属性]]の[[属性値]]は、 [[キーワード][列挙属性]]のいずれかと [[ASCII大文字・小文字不区別]]で一致しなければ[MUST[なりません]] [SRC[>>9]]。 [34] ただし、[[不適合]]とされる[[キーワード][列挙属性]]であっては[MUST[なりません]] [SRC[>>9]]。 ;; [35] [[キーワード][列挙属性]]の前後に[[空白]]を挿入することは、 認められていません。 [54] なお、[[キーワード][列挙属性]]は[[空文字列]]となることもあります。 [55] [[キーワード][列挙属性]]の多くは[[ASCII英数字]]で構成されていますが、 [CODE[enctype]] [[属性]]のように[[記号]]が含まれることもあります。 [[非ASCII文字]]が現れる[[列挙属性]]はありません。 * 処理 [36] [[要素]][VAR[要素]]の[[列挙属性]][VAR[名前]]の[F[状態][列挙属性]]は、 次のようにして得られます [SRC[>>9]]。 [FIG(steps)[ = [37] [VAR[要素]]に[VAR[名前]][[内容属性]]が指定されている場合、 == [38] [VAR[値]]を、[VAR[要素]]の[VAR[名前]][[属性値]]に設定します。 == [39] [VAR[要素]]の[VAR[名前]][[属性]]に[VAR[値]]と [[ASCII大文字・小文字不区別]]で等しい[[キーワード][列挙属性]]がある場合、 === [40] その[[キーワード][列挙属性]]に対応する[[状態][列挙属性]]を返します。 == [43] それ以外で、[[非妥当値既定値]]がある場合、 === [44] その[[非妥当値既定値]]の[[状態][列挙属性]]を返します。 == [41] それ以外で、[[欠値既定値]]がある場合、 === [42] その[[欠値既定値]]の[[状態][列挙属性]]を返します。 == [45] それ以外の場合、 === [46] [CODE[null]] を返します。 = [47] それ以外の場合、 == [48] [[欠値既定値]]がある場合、 === [49] その[[欠値既定値]]の[[状態][列挙属性]]を返します。 == [50] それ以外の場合、 === [51] [CODE[null]] を返します。 ]FIG] * IDL 属性 [57] 多くの[[列挙属性]]には、それを[[反映]] [SRC[>>56]] する [[IDL属性]]があります。 * 列挙属性の一覧 [12] 現在の [[HTML]] には次の[[列挙属性]]があります。 [FIG(table)[ [58] [[HTML]] の[[列挙属性]] :attr: [[属性]] :empty: [[空文字列]] :non: [[不適合]][[キーワード][列挙属性]] :missing: [[欠値既定値]] :invalid: [[非妥当値既定値]] :idl: [[IDL属性]] :attr: [CODE(HTMLa)@en[as][]] :idl: [[既知値のみに限定]] :attr: [CODE(HTMLa)@en[autocapitalize]] :missing: あり :invalid: あり :idl: 特殊 :attr: [CODE(HTMLa)@en[autocomplete]] :missing: あり :invalid: [[欠値既定値]] :idl: [[既知値のみに限定]] :attr: [CODE(HTMLa)@en[[[contenteditable]]]] :empty: あり :missing: 別 :invalid: [[欠値既定値]] :idl: 特殊 :attr: [CODE(HTMLa)@en[crossorigin]] :empty: あり :missing: 別 :invalid: あり :idl: [CODE[[[DOMString]][[?][nullable]]]] :attr: [CODE(HTMLa)@en[decoding][]] :invalid: [[欠値既定値]] :missing: あり :idl: [[既知値のみに限定]] :attr: [CODE(HTMLa)@en[[[dir]]]] :idl: [[既知値のみに限定]] :attr: [CODE(HTMLa)@en[[[draggable]]]] :missing: 別 :invalid: [[欠値既定値]] :idl: 特殊 :attr: [CODE(HTMLa)@en[[[enctype]]]] :invalid: あり :missing: あり :idl: [[既知値のみに限定]] :attr: [CODE(HTMLa)@en[[[formenctype]]]] :invalid: あり :#: no missing value default :idl: [[既知値のみに限定]] :attr: [CODE(HTMLa)@en[inputmode]] :missing: 別 :invalid: [[欠値既定値]] :idl: [[既知値のみに限定]] :attr: [CODE(HTMLa)@en[kind][]] :invalid: あり :missing: あり :idl: [[既知値のみに限定]] :attr: [CODE(HTMLa)@en[[[method]]]] :invalid: あり :missing: あり :idl: [[既知値のみに限定]] :attr: [CODE(HTMLa)@en[[[formmethod]]]] :invalid: あり :idl: [[既知値のみに限定]] :attr: [CODE(HTMLa)@en[preload]] :missing: [[実装定義]] :empty: あり :invalid: [[欠値既定値]] :idl: [[既知値のみに限定]] :attr: [CODE(HTMLa)@en[referrerpolicy]] :missing: あり :invalid: あり :empty: あり :idl: [[既知値のみに限定]] :attr: [CODE(HTMLa)@en[[[scope]]]] :missing: 別 :invalid: [[欠値既定値]] :idl: [[既知値のみに限定]] :attr: [CODE(HTMLa)@en[[[shape]]]] :non: あり :missing: あり :invalid: [[欠値既定値]] :idl: [CODE(IDL)@en[DOMString]] :attr: [CODE(HTMLa)@en[[[spellcheck]]]] :missing: 別 :empty: あり :invalid: [[欠値既定値]] :idl: 特殊 :attr: [CODE(HTMLa)@en[translate]] :missing: 別 :empty: あり :invalid: [[欠値既定値]] :idl: 特殊 :attr: [CODE(HTMLa)@en[type][