Element: ariaChecked 屬性

Baseline 2023
新推出

自 ⁨2023 年 10 月⁩ 以來,此功能已在最新裝置和瀏覽器版本中得到支援。此功能可能無法在舊裝置或瀏覽器上執行。

Element 介面的 ariaChecked 屬性反映了 aria-checked 屬性的值,該屬性指示了複選框、單選按鈕和其他具有選中狀態的控制元件的當前“選中”狀態。

注意: 儘可能使用 type="checkbox" 的 HTML <input> 元素,因為該元素具有內建的語義,不需要 ARIA 屬性。

一個字串,其值可能為以下之一:

"true"

元素已選中。

"mixed"

表示三態複選框或選單項複選框的混合模式值。

"false"

元素支援選中,但當前未選中。

"undefined"

元素不支援選中。

示例

在此示例中,ID 為 checkBoxInput 的元素的 aria-checked 屬性設定為 "false",表示此輸入當前未選中。使用 ariaChecked,我們將值更新為 "true"。

html
<span
  role="checkbox"
  id="checkBoxInput"
  aria-checked="false"
  tabindex="0"
  aria-labelledby="chk1-label">
</span>
<label id="chk1-label">Remember my preferences</label>
js
let el = document.getElementById("checkBoxInput");
console.log(el.ariaChecked); // "false"
el.ariaChecked = "true";
console.log(el.ariaChecked); // "true"

規範

規範
無障礙富網際網路應用程式 (WAI-ARIA)
# dom-ariamixin-ariachecked

瀏覽器相容性

另見