Element：ariaDisabled 属性

Baseline 2023

新推出

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

Element 接口的 ariaDisabled 属性反映了 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>

let el = document.getElementById("saveChanges");
console.log(el.ariaDisabled); // "true"
el.ariaDisabled = "false";
console.log(el.ariaDisabled); // "false"

规范

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

浏览器兼容性

帮助改进 MDN

了解如何贡献

此页面最后修改于 2025 年 3 月 6 日，由 MDN 贡献者修改。

在 GitHub 上查看此页面 • 报告此内容的问题