Element: role プロパティ
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.
role は Element インターフェイスのプロパティで、この要素に対して明示的に設定された WAI-ARIA ロールを返します。
すべての HTML 要素には暗黙の ARIA ロールが割り当てられており、そのロールが generic であっても同様です。 この 意味的な関連付けにより、ツールは、その型のそれ以外のオブジェクトに対するユーザーの期待と整合性のある方法で、オブジェクトを表示し、オブジェクトの操作に対応できるようになります。 role 属性は、要素の ARIA ロールを明示的に設定するために使用する属性であり、暗黙のロールを上書きします。例えば、暗黙的に list ロールを持つ <ul> には、明示的に role="treegrid" が設定される場合があります。 role プロパティは、明示的に設定された role 属性の値（この場合は treegrid）を反映します。明示的に設定されていない限り、要素の暗黙的な list ロールは返しません。
定義されている ARIA ロールの完全な一覧は、ARIA ロールリファレンスページで見ることができます。
値
文字列。 role 属性の値、または明示的に設定されていない場合 null です。
例
この例では、 alt 属性が空または欠落している画像には、 presentation の role が指定されています。
const images = document.querySelectorAll("img");
images.forEach((image) => {
if (!image.alt) {
image.role = "presentation";
}
});
仕様書
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-role |