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
未知規範

另請參閱