元素:ariaDisabled 属性

基线 2023

新可用

2023 年 10 月起,此功能可在最新的设备和浏览器版本中使用。此功能可能无法在较旧的设备或浏览器中使用。

ariaDisabledElement 接口的一个属性,它反映了 aria-disabled 属性的值,该属性指示元素是可感知的但处于禁用状态,因此无法编辑或操作。

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

一个字符串,包含以下值之一

"true"

元素及其所有可聚焦后代都处于禁用状态,但可以感知,并且用户无法更改其值。

"false"

元素已启用。

示例

在此示例中,ID 为 saveChanges 的元素上的 aria-disabled 属性设置为 "true",表示此输入当前处于禁用状态。使用 ariaDisabled,我们将值更新为 "false"。

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

规范

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

浏览器兼容性

BCD 表格仅在浏览器中加载