元素：ariaPressed 属性

基线 2023

新可用

自 2023 年 10 月起，此功能在最新的设备和浏览器版本中均可使用。此功能可能在较旧的设备或浏览器中不起作用。

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

注意： 在可能的情况下，请使用 HTML <input> 元素，其 type="button" 属性或 <button> 元素，因为这些元素具有内置语义，不需要 ARIA 属性。

价值

包含以下值之一的字符串

"true"

该元素已按下。

"false"

该元素支持按下，但当前未按下。

"混合"

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

"未定义"

该元素不支持被按下。

示例

在这个例子中，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

浏览器兼容性

BCD 表格只在浏览器中加载

另请参阅