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

浏览器兼容性