Element: ariaHidden 屬性

Baseline 2023
新推出

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

Element 介面的 ariaHidden 屬性反映了 aria-hidden) 屬性的值,該屬性指示元素是否暴露給輔助功能 API。

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

"true"

元素被隱藏,不向輔助功能 API 公開。

"false"

元素像渲染時一樣向輔助功能 API 公開。

"undefined"

元素的隱藏狀態由使用者代理根據其是否渲染來決定。

示例

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

html
<div id="hidden" aria-hidden="true">Some things are better left unsaid.</div>
js
let el = document.getElementById("hidden");
console.log(el.ariaHidden); // true
el.ariaHidden = "false";
console.log(el.ariaHidden); // false

規範

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

瀏覽器相容性