大网数据广告活动
Web 标准与前端开发

HTMLInputElement: checked property

· 52CE 我爱测

The **`checked`** property of the HTMLInputElement interface specifies the current checkedness of the element; that is, whether the form control is checked or not.

HTML DOM

The checked property of the HTMLInputElement interface specifies the current checkedness of the element; that is, whether the form control is checked or not.

The boolean checked property is relevant to the radio (<input type="radio">) and checkbox (<input type="checkbox">) input types.

The presence of the HTML checked attribute indicates the checkbox is checked by default. It does not indicate whether this checkbox is currently checked: if the checkbox's state is changed, this content attribute does not reflect the change; only the HTMLInputElement's checked IDL property is updated. The checked attribute is reflected by the HTMLInputElement.defaultChecked property.

When a radio input checked property is true, all other radio inputs with the same HTMLInputElement.name are false. If any radio button in a same-named group of radio buttons is HTMLInputElement.required, as long as one button in the group is checked, the ValidityState object's read-only ValidityState.valueMissing property for each radio button in the group will be false.

A checkbox's value is only included in the submitted data upon form submission if checked is true. The value of the HTMLInputElement.indeterminate property has no effect on a checkbox's checked value.

Value

A boolean.

Examples

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

Specifications

Browser compatibility

See also

  • input
  • HTMLInputElement.validity
  • :checked pseudo-class

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。