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 上檢視此頁面 • 報告此內容的問題