Element: ariaPressed 属性

Baseline 2023
新推出

自 ⁨2023 年 10 月⁩ 以来,此功能已在最新设备和浏览器版本中得到支持。此功能可能无法在旧设备或浏览器上运行。

Element 接口的 ariaPressed 属性反映了 aria-pressed 属性的值,该属性指示切换按钮当前是否处于“按下”状态。

注意: 尽可能使用带有 type="button" 的 HTML <input> 元素或 <button> 元素,因为它们具有内置的语义,不需要 ARIA 属性。

一个字符串,其值可能为以下之一:

"true"

元素被按下。

"false"

元素支持被按下,但当前未被按下。

"mixed"

指示三态切换按钮的混合模式值。

"undefined"

元素不支持被按下。

示例

在此示例中,ID 为 saveChanges 的元素上的 aria-pressed 属性设置为“false”,表示此输入当前未被按下。使用 ariaPressed,我们将值更新为“true”。

html
<div id="saveChanges" tabindex="0" role="button" aria-pressed="false">Save</div>
js
let el = document.getElementById("saveChanges");
console.log(el.ariaPressed); // "false"
el.ariaPressed = "true";
console.log(el.ariaPressed); // "true"

规范

规范
无障碍富互联网应用程序 (WAI-ARIA)
# dom-ariamixin-ariapressed

浏览器兼容性

另见