Element: ariaSelected 屬性

Baseline 2023
新推出

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

Element 介面的 ariaSelected 屬性反映了 aria-selected 屬性的值,該屬性表示具有選中狀態的元素的當前“選中”狀態。

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

"true"

專案已被選中。

"false"

專案未被選中。

"undefined"

專案不可選。

示例

在此示例中,ID 為 tab-id 的元素上的 aria-selected 屬性設定為“true”。使用 ariaSelected,我們將值更新為“false”。

html
<button role="tab" aria-selected="true" aria-controls="tabpanel-id" id="tab-id">
  Tab label
</button>
js
let el = document.getElementById("tab-id");
console.log(el.ariaSelected); // true
el.ariaSelected = "false";
console.log(el.ariaSelected); // false

規範

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

瀏覽器相容性

另見