* [CODE(HTMLa)@en[required]] 属性 (HTML)
[1] [[HTML]] の[[フォーム制御子]]の
[DFN[[CODE(HTMLa)@en[required]] [[属性]]]]は、
[[フォーム]]を[[提出]]する前に[[値]]がその[[フォーム制御子]]に入力されなければならないことを示します。
[2]
:状態:[[WHATWG]] [[WD]]
:[[要素型]]:[[フォーム制御子]]
:[[属性名]]:[CODE(HTMLa)@en[[[required]]]]
:[[属性値]]:([[ブール型属性]] >>12)
:[[既定値]]:([[偽]] >>12)
[3]
仕様書:
- [[Web Forms 2.0]]
-- [CSECTION@en[2.7. The [CODE(HTMLa)@en[[[required]]]] attribute]]
-- [CSECTION@en[2.15. Extensions to file upload controls]]
--
** 属性値
[12]
@@
** 提出
[4]
[[利用者]]は、[[フォーム]]を[[提出]]する前に、
[CODE(HTMLa)@en[[[required]]]] とされた[[フォーム制御子]]に値を入力[['''しなければなりません''']]。
[SRC@en[WF2 2.7]]
[5]
[CODE(HTMLa)@en[[[required]]]] [[属性]]は、
次の条件に1つも該当''しない''[[フォーム制御子]]に適用されます
[SRC@en[WF2 2.7]]。
- [CODE(HTML)@en[[[hidden]]]]
- [CODE(HTML)@en[[[image]]]]
- [[ボタン]] ([CODE(HTML)@en[[[submit]]]],
[CODE(HTML)@en[[[move-up]]]] など)
- [CODE(HTMLe)@en[[[select]]]]
- [CODE(HTMLe)@en[[[output]]]]
- [CODE(HTMLa)@en[[[disabled]]]]
- [CODE(HTMLa)@en[[[readonly]]]]
[6]
[CODE(HTMLa)@en[[[required]]]] で、
値を持たない[[フォーム制御子]]には、
[[旗]] [CODE(DOM)@en[[[valueMissing]]]] が使われます。
[SRC@en[WF2 2.7]]
[7]
[CODE(HTML)@en[[[checkbox]]]] では、
その[[フォーム]]中の同じ [CODE(HTMLa)@en[[[name]]]] の1つ以上の
[CODE(HTML)@en[[[checkbox]]]]
が[[チェック]]されていなければならないことを表します。
[SRC@en[WF2 2.7]]
[8]
[CODE(HTML)@en[[[radio]]]] では、
その[[ラジオ群]]内の丁度1つが[[チェック]]されていなければならないことを表します。
[SRC@en[WF2 2.7]]
[9]
[CODE(HTML)@en[[[file]]]] では、
([CODE(HTMLa)@en[[[min]]]] や [CODE(HTMLa)@en[[[max]]]]
にかかわらず)
最低1つの[[妥当]]な
([[提出]]時に実際に[[うp]]され得る)
[[ファイル]]が選択されていなければならないことを表します。
[SRC@en[WF2 2.7, 2.15]]
[10]
それ以外の種類の[[フォーム制御子]]では、
[WEAK[[[空白]]も含め]]何らかの値が与えられていなければならないことを表します。
[SRC@en[WF2 2.7]]
[[#comment]]
** 歴史
[13] この[[属性]]は [[Web Forms 2.0]]
で導入されました。
[[#comment]]
** 例
[11]
[PRE(HTML example code)[
]PRE]
この例では、[[利用者]]は名前を入力しなければなりませんが、
注釈は空でも構いません。[[利用者エージェント]]は、
名前が入力されるまでは[[提出]]を認めてはいけません。
[SRC@en[WF2 2.7]]
[[#comment]]
** メモ
[14]
[CITE[A List Apart: Articles: Validating a Custom DTD]] ([CODE[2007-08-17 23:05:01 +09:00]] 版)
([[名無しさん]])
[15]
[CITE@en['''['''WF2''']''' backwards compatibility with values of custom required attributes]] ([[Hallvord R. M. Steen]] 著, [CODE[2008-01-16 22:04:01 +09:00]] 版)
[16] [CITE['''['''whatwg''']''' Form validation against invisible controls]]
([TIME[2010-06-14 23:46:28 +09:00]] 版)
[17] [CITE['''['''whatwg''']''' Form validation against invisible controls]]
([TIME[2010-06-14 23:46:39 +09:00]] 版)
[18] [CITE['''['''whatwg''']''' Form validation against invisible controls]]
([TIME[2010-08-05 08:43:01 +09:00]] 版)
[19] [CITE@en[HTML5 Revision Tracker]]
([TIME[2010-08-12 07:41:23 +09:00]] 版)
[20] [CITE['''['''whatwg''']''' Constraint validation feedback (various threads)]]
([TIME[2010-08-12 07:41:12 +09:00]] 版)
[21] [CITE['''['''whatwg''']''' Constraint validation feedback (various threads)]]
([TIME[2010-11-21 07:06:58 +09:00]] 版)