元素: ariaChecked 属性

基线 2023

新功能

自 2023 年 10 月起，此功能在最新的设备和浏览器版本中均可使用。此功能可能无法在较旧的设备或浏览器中使用。

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

注意： 尽可能使用 HTML <input> 元素，其中 type="checkbox"，因为此元素具有内置语义，不需要 ARIA 属性。

值

一个字符串，包含以下值之一

"true"

该元素已选中。

"mixed"

表示三态复选框或菜单项复选框的混合模式值。

"false"

元素支持选中，但当前未选中。

"undefined"

元素不支持选中。

示例

在这个例子中，aria-checked 属性在 ID 为 checkBoxInput 的元素上设置为 "false"，表示该输入当前未选中。使用 ariaChecked 我们将值更新为 "true"。

html
<span
  role="checkbox"
  id="checkBoxInput"
  aria-checked="false"
  tabindex="0"
  aria-labelledby="chk1-label">
</span>
<label id="chk1-label">Remember my preferences</label>
js
let el = document.getElementById("checkBoxInput");
console.log(el.ariaChecked); // "false"
el.ariaChecked = "true";
console.log(el.ariaChecked); // "true"

规范

规范
无障碍富互联网应用 (WAI-ARIA)
# dom-ariamixin-ariachecked

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅