HTMLInputElement: checked 属性

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

HTMLInputElement 接口的 checked 属性指定了元素的当前选中状态;也就是说,表单控件是否被选中。

布尔型 checked 属性与 radio<input type="radio">)和 checkbox<input type="checkbox">)输入类型相关。

HTML checked 属性的存在表示复选框默认是选中的。它不指示当前复选框是否被选中:如果复选框的状态发生变化,此内容属性不会反映此变化;只有 HTMLInputElementchecked IDL 属性会被更新。checked 属性由 defaultChecked 属性反映。

当一个单选按钮的 checked 属性为 true 时,所有具有相同 name 的其他单选按钮的该属性均为 false。如果同一组单选按钮中的任何一个被 required,只要组内有一个按钮被 checked,组内每个单选按钮的 ValidityState 对象的只读 valueMissing 属性将为 false

在表单提交时,只有当 checked 为 true 时,复选框的值才会被包含在提交的数据中。HTMLInputElement.indeterminate 属性的值对复选框的 checked 值没有影响。

布尔值。

示例

js
const inputElement = document.getElementById("contactMail");
console.log(inputElement.checked);
inputElement.checked = true;

规范

规范
HTML
# dom-input-checked

浏览器兼容性

另见