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

aria-checked

· 52CE 我爱测

`aria-checked` 属性指示复选框、单选按钮和其他小部件的当前“已选中”状态。

aria-checked 属性指示复选框、单选按钮和其他小部件的当前“已选中”状态。

[!NOTE] 在可能的情况下,请使用带有 type="checkbox" 和 type="radio" 的 HTML input 元素,因为它们具有内置语义,并且不需要 ARIA 属性。

描述

aria-checked 属性指示元素是否被选中(true)、未选中(false)或者选中状态不确定(mixed),表示它既未被选中也未取消选中。mixed 值受到 checkbox 和 menuitemcheckbox 的三态输入角色支持。

mixed 值不受 radio、menuitemradio 或 switch 以及继承自这些角色的元素支持。如果不支持 mixed,则值将为 false。

<span
  role="checkbox"
  id="checkBoxInput"
  aria-checked="false"
  tabindex="0"
  aria-labelledby="chk15-label"></span>
<label id="chk15-label">订阅时事通讯</label>

tabindex 属性是为了启用焦点。需要 JavaScript 切换 aria-checked 状态。如果此复选框是可提交表单的一部分,则需要更多 JavaScript 来设置名称和值。

以上代码也可以写为:

<input type="checkbox" id="chk15-label" name="Subscribe" />
<label for="chk15-label">订阅时事通讯</label>

通过使用具有 type="checkbox" 的 input 元素而不是 ARIA,无需任何 JavaScript。

值

  • false
    • : 元素支持被选中,但当前未被选中。
  • true
    • : 元素被选中。
  • mixed
    • : 仅适用于 checkbox 和 menuitemcheckbox,相当于 indeterminate,表示既不选中也不取消选中的混合模式值。
  • undefined(默认)
    • : 元素不支持被选中。

关联角色

适用于以下角色:

关联接口

  • Element.ariaChecked
    • : Element 接口的 ariaChecked 属性反映了 aria-checked 属性的值。
  • ElementInternals.ariaChecked
    • : ElementInternals 接口的 ariaChecked 属性反映了 aria-checked 属性的值。
myHTMLElement.ariaChecked = true;

规范

参见

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

资料来源与适用范围

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

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

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