ElementInternals: ariaLabel プロパティ

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.

ariaLabelElementInternals インターフェイスのプロパティで、 aria-label 属性の値を反映し、現在の要素にラベル付けする文字列値を定義します。

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

文字列です。

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

js
this.internals_.ariaLabel = "close";

仕様書

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

ブラウザーの互換性

BCD tables only load in the browser