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

メモ: ElementInternals に aria 属性を設定することで、カスタム要素に既定値を定義することができます。これらは作成者が定義した属性によって上書きされる可能性がありますが、作成者が属性を削除したり、追加しなかった場合でも確実に既定値を定義することができます。より詳しい情報は、 Accessibility Object Model explainer を参照してください。

値

以下のいずれかの値を持つ文字列です。

"true"

要素とフォーカス可能なすべての子孫は無効ですが、知覚可能であり、それらの値はユーザーによって変更できません。

"false"

要素が有効になっています。

例

この例では、 ariaDisabled の値を "true" に設定しています。

js
this.internals_.ariaDisabled = "true";

仕様書

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

ブラウザーの互換性

BCD tables only load in the browser