* [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]]
<IW:WF2:"#the-required">
-- [CSECTION@en[2.15. Extensions to file upload controls]]
<IW:WF2:"#upload">
-- <http://www.whatwg.org/specs/web-forms/current-work/#relation>

** 属性値

[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)[
<ul>
  <li><label> Name: <input type="text" name="name" required="required" /></label></li>
  <li><label> Comment: <input type="text" name="comment" /></label></li>
</ul>
]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]] 版) <http://www.alistapart.com/articles/customdtd/>
([[名無しさん]])

[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]] 版) <http://lists.w3.org/Archives/Public/public-html/2008Jan/0143.html>


[16] [CITE['''['''whatwg''']''' Form validation against invisible controls]]
([TIME[2010-06-14 23:46:28 +09:00]] 版)
<http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2010-June/026733.html>

[17] [CITE['''['''whatwg''']''' Form validation against invisible controls]]
([TIME[2010-06-14 23:46:39 +09:00]] 版)
<http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2010-June/026734.html>