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

Element:ariaChecked 属性

· 52CE 我爱测

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

DOM

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

[!NOTE] 应尽可能使用 type="checkbox" 的 HTML input 元素,因为该元素内置语义,无需 ARIA 属性。

值

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

  • "true"
    • : 元素已选中。
  • "mixed"
    • : 指示三态复选框或 menuitemcheckbox 的混合状态值。
  • "false"
    • : 元素支持被选中,但当前未选中。
  • "undefined"
    • : 元素不支持被选中。

示例

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

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

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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