aria-checked

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

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

描述

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

mixed 值不受 radio、menuitemradio 或 switch 以及继承自这些角色的元素支持。如果在不支持的情况下设置 mixed，则该值将为 false。

html
<span
  role="checkbox"
  id="checkBoxInput"
  aria-checked="false"
  tabindex="0"
  aria-labelledby="chk15-label"></span>
<label id="chk15-label">Subscribe to the newsletter</label>

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

以上内容可以写成

html
<input type="checkbox" id="chk15-label" name="Subscribe" />
<label for="chk15-label">Subscribe to the newsletter</label>

通过使用带有 type="checkbox" 的 <input> 元素代替 ARIA，无需任何 JavaScript。

值

false

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

true

该元素已选中。

mixed

仅适用于 checkbox 和 menuitemcheckbox，等效于 indeterminate，表示既未选中也未未选中的混合模式值。

undefined（默认）

该元素不支持选中。

关联角色

在角色中使用

关联接口

Element.ariaChecked

ariaChecked 属性是 Element 接口的一部分，它反映了 aria-checked 属性的值。

ElementInternals.ariaChecked

ariaChecked 属性是 ElementInternals 接口的一部分，它反映了 aria-checked 属性的值。

js
myHTMLElement.ariaChecked = true;

规范

规范
可访问的富互联网应用程序 (WAI-ARIA)
# aria-checked
未知规范

另请参阅