此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Element:ariaChecked 属性

基线
广泛可用

自 2023年10月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

Element 接口的 ariaChecked 属性反映 aria-checked 属性的值,该属性指示复选框、单选按钮及其他具有选中状态的小部件当前的“选中”状态。

备注:应尽可能使用 type="checkbox" 的 HTML <input> 元素,因为该元素内置语义,无需 ARIA 属性。

具有以下值之一的字符串:

"true"

元素已选中。

"mixed"

指示三态复选框或 menuitemcheckbox 的混合状态值。

"false"

元素支持被选中,但当前未选中。

"undefined"

元素不支持被选中。

示例

此示例中,ID 为 checkBoxInput 的元素的 aria-checked 属性设为 "false",表示该输入框当前未选中。使用 ariaChecked 将其更新为 "true"

html
<span
  role="checkbox"
  id="checkBoxInput"
  aria-checked="false"
  tabindex="0"
  aria-labelledby="chk1-label">
</span>
<label id="chk1-label">记住我的偏好设置</label>
js
let el = document.getElementById("checkBoxInput");
console.log(el.ariaChecked); // "false"
el.ariaChecked = "true";
console.log(el.ariaChecked); // "true"

规范

规范
Accessible Rich Internet Applications (WAI-ARIA)
# dom-ariamixin-ariachecked

浏览器兼容性

参见