Element: ariaDisabled プロパティ

Baseline 2023

Newly available

Since ⁨October 2023⁩, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

ariaDisabled は Element インターフェイスのプロパティで、aria-disabled 属性の値を反映し、要素が知覚可能だが無効であり、編集や他の処理をすることはできないことを示します。

メモ: 可能であれば、<input> 要素に type="button" を使用するか、<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"

仕様書

Specification
Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariadisabled

ブラウザーの互換性

Help improve MDN

Learn how to contribute

This page was last modified on ⁨2025年3月21日⁩ by MDN contributors.

View this page on GitHub • Report a problem with this content