<input type="checkbox">

HTML input 元素 <input type="checkbox"> 允许你为表单中(或不在表单中)的提交项选择一个单一值。

注意: 若表单提交时,checkbox 未勾选,则提交的值并非为 value=unchecked;此时的值不会被提交到服务器。

属性

该元素包含全局属性

checked

type属性的值为checkbox 时, 这个属性的存在表示 input 是否默认被选中。你可以将该属性设置为checked="checked",或更简单地只设置为checked。

value
指定 input 的值。如果省略,获取该元素的值的结果为字符串"on"。
请注意,如果 value 值发生改变后页面重新加载,Gecko 和 IE会忽略 HTML 源代码中设置的 value 值
indeterminate
指定 checkbox 处于不定状态(在大多数平台,这样会产生一个划过 checkbox 的横线)。

示例

<p>
  <input type="checkbox" id="cbox1" value="first_checkbox">
  <label for="cbox1">This is the first checkbox</label>
</p>
<p>
  <input type="checkbox" id="cbox2" value="second_checkbox" checked="checked">
  <label for="cbox2">This is the second checkbox, which is checked</label>
</p>

以上代码将产生 2 个 checkbox,如下所示:

规范

规范 状态
HTML Living Standard
<checkbox>
Living Standard  
HTML5
<checkbox>
Recommendation  
HTML 4.01 Specification
<checkbox>
Recommendation  

浏览器兼容性

No compatibility data found for html.elements.input.input-checkbox.
Check for problems with this page or contribute missing data to mdn/browser-compat-data.