ARIA: aria-checked 属性

描述

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>

通过使用 <input> 元素和 type="checkbox" 而不是 ARIA，就不需要任何 JavaScript。

值

false: 元素支持选中，但当前未选中。
true: 元素已选中。
mixed: 仅适用于 checkbox 和 menuitemcheckbox，相当于 indeterminate，表示一种混合模式值，既不是选中也不是未选中。
未定义（默认）: 元素不支持选中。