Element: ariaChecked 属性

Baseline 2023
新推出

自 ⁨2023 年 10 月⁩ 以来,此功能已在最新设备和浏览器版本中得到支持。此功能可能无法在旧设备或浏览器上运行。

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

注意: 尽可能使用 type="checkbox" 的 HTML <input> 元素,因为该元素具有内置的语义,不需要 ARIA 属性。

一个字符串,其值可能为以下之一:

"true"

元素已选中。

"mixed"

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

"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">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

浏览器兼容性

另见