[1] [[HTML]] の [CODE(HTMLe)[[[input]]]] 要素は、 [CODE(HTMLa)[[[type]]]]
属性が [DFN[[CODE(HTMLa)[checkbox]]]] の時、[DFN[チェック箱[[制御子]]]]を定義します。
[2] 仕様書:
- [[HTML 4]] ([[Web Forms 1.0]])
-- checkboxes
-- 17.4 The [CODE(HTMLe)[INPUT]] element
[3] 属性:
,属性名 ,属性値 ,既定値 ,説明 ,出典
,[CODE(HTMLa)[[[accesskey]]]] ,[CODE(SGML)[%[[Character]]]] , , ,[HTML 4]
,[CODE(HTMLa)[[[align]]]] , , ,配置 ,[HTML 4] 非推奨
,[CODE(HTMLa)[[[checked]]]] ,([[真偽値属性]]) ,([[偽]]) ,初期状態 ,[HTML 4]
,[CODE(HTMLa)[[[class]]]] , , ,[[級]] ,[HTML 4] %[[coreattrs]]
,[CODE(HTMLa)[[[datafld]]]] , , ,データ欄 ,[HTML 4] 予約
,[CODE(HTMLa)[[[dataformatas]]]] , , ,データ書式 ,[HTML 4] 予約
,[CODE(HTMLa)[[[datasrc]]]] ,[CODE(SGML)[%[[URI]]]] ,(なし) ,データ源 ,[HTML 4] 予約
,[CODE(HTMLa)[[[dir]]]] , , ,[[書字方向]] ,[HTML 4] %[[i18n]]
,[CODE(HTMLa)[[[disabled]]]] ,(真偽値属性) ,(偽) ,無効 ,[HTML 4]
,[CODE(HTMLa)[[[id]]]] , , ,一意識別子 ,[HTML 4] %coreattrs
,[CODE(HTMLa)[[[lang]]]] , , ,[[自然言語]] ,[HTML 4] %i18n
,[CODE(HTMLa)[[[xml]]:lang]] , , ,自然言語 ,[XHTML 1]
,[CODE(HTMLa)[[[language]]]] , , ,スクリプト言語 ,[[WinIE 4]]+
,[CODE(HTMLa)[[[name]]]] , , ,制御子名 ,[HTML 4]
,[CODE(HTMLa)[[[onblur]]]] ,[CODE(SGML)[%[[Script]]]] , ,焦点を失した時 ,[HTML 4]
,[CODE(HTMLa)[[[onchange]]]] ,[CODE(SGML)[%[[Script]]]] , ,現在値変更時 ,[HTML 4]
,[CODE(HTMLa)[[[onclick]]]] , , , ,[HTML 4] %[[events]]
,[CODE(HTMLa)[[[ondblclick]]]] , , , ,[HTML 4] %events
,[CODE(HTMLa)[[[onfocus]]]] ,[CODE(SGML)[%[[Script]]]] , ,焦点を得た時 ,[HTML 4]
,[CODE(HTMLa)[[[onkeydown]]]] , , , ,[HTML 4] %events
,[CODE(HTMLa)[[[onkeypress]]]] , , , ,[HTML 4] %events
,[CODE(HTMLa)[[[onkeyup]]]] , , , ,[HTML 4] %events
,[CODE(HTMLa)[[[onmousedown]]]] , , , ,[HTML 4] %events
,[CODE(HTMLa)[[[onmousemove]]]] , , , ,[HTML 4] %events
,[CODE(HTMLa)[[[onmouseout]]]] , , , ,[HTML 4] %events
,[CODE(HTMLa)[[[onmouseover]]]] , , , ,[HTML 4] %events
,[CODE(HTMLa)[[[onmouseup]]]] , , , ,[HTML 4] %events
,[CODE(HTMLa)[[[onselect]]]] ,[CODE(SGML)[%[[Script]]]] , ,文選択時 ,[HTML 4]
,[CODE(HTMLa)[[[readonly]]]] ,(真偽値属性) ,(偽) ,読取専用 ,[HTML 4]
,[CODE(HTMLa)[[[style]]]] , , ,スタイル情報 ,[HTML 4] %coreattrs
,[CODE(HTMLa)[[[tabindex]]]] ,[CODE(SGML)[[[NUMBER]]]] , ,タブ順 ,[HTML 4]
,[CODE(HTMLa)[[[title]]]] , , ,注釈的題 ,[HTML 4] %coreattrs
,[CODE(HTMLa)[[[type]]]] ,'''[CODE(HTML)[checkbox]]''' ,[CODE(HTML)[[[text]]]] ,制御子の種類 ,[HTML 4]
,[CODE(HTMLa)[[[value]]]] , , ,初期値 ,[HTML 4]
,[CODE(HTMLa)[[[vcard_name]]]] , , ,自動補完 ,[[WinIE 5]]+
[[#comment]]
* 名前
[4] 制御子名は [CODE(HTMLa)[name]] 属性で指定します。
一つの[[フォーム]]内で、複数個のチェック箱が同じ制御子名であっても構いません。
この機能は、例えば、ある特性について複数の値を選べる場合に使えます。
[SRC[HTML 4 17.2.1]]
[[#comment]]
* 初期状態と現在状態
[7] [CODE(HTMLa)[[[checked]]]] 属性が指定されていれば「入」の状態です。
[SRC[HTML 4 17.2.1]]
[8] 利用者は「入」と「切」の状態を切り替えることができます。
[SRC[HTML 4 17.2.1]]
[[#comment]]
* 成功
[6] フォームの[[提出]]の時に、「入」の状態になっているチェック箱制御子だけが[[成功]]状態です。
[[#comment]]
* 他との関係
[5] 同じ制御子名のチェック箱を複数用意することで、
一つの名前に対して複数の値の入・切を選択させられます。
これは [CODE(HTMLe)[[[select]]]] 要素によるメニュー制御子と同じ効能です。
[9] 同じように「入」と「切」の状態を持つ制御子に
[CODE(HTML)[[[radio]]]] があります。こちらは、複数の選択肢から
1つだけを選びます。
[[#comment]]
* メモ
[10]
[CITE[にチェックをつける方法。]]
([[名無しさん]] [sage])
[11] [CITE[''''''[''''''whatwg'''''']'''''' Can we make checkboxes readonly?]]
( ([TIME[2012-07-11 07:59:03 +09:00]] 版))
[12] [CITE@en[Web Applications 1.0 r2257 WF2: and significant fallout therefrom.]]
( ([TIME[2008-10-02 12:10:00 +09:00]] 版))
[13] [CITE[''''''[''''''whatwg'''''']'''''' Forms-related feedback]]
( ([TIME[2013-12-03 20:56:46 +09:00]] 版))
[14] [CITE@ja[IE10 における placeholder 属性をもつ textarea 要素、または value 属性のない type="checkbox" の input 要素の clone に関するはまりどころ - ひだまりソケットは壊れない]]
( ([TIME[2014-05-02 09:18:43 +09:00]] 版))
[15] [CITE@en[Align activation behavior with changes to DOM Standard]]
([[annevk]]著, [TIME[2016-10-21 00:06:40 +09:00]])