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，表示一種混合模式值，既不是選中也不是未選中。
未定義（預設）: 元素不支援選中。