このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
Element: ariaRelevant プロパティ
Baseline 2023Newly available
Since October 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
非標準: この機能は標準化されていません。非標準の機能はブラウザーの対応が限られ、将来的に変更または削除される可能性があるため、本番環境での使用は推奨されません。ただし、標準の選択肢が存在しない特定のケースでは、有効な代替手段となる場合があります。
ariaRelevant はElement インターフェイスのプロパティで、aria-relevant 属性の値を反映します。この属性は、ライブ領域内のアクセシビリティツリーが変更されたときにユーザーエージェントがどのような通知を発生させるかを示します。これはaria-live 領域内のどのような変更が関連性があり、告知されるべきかを記述するために使用します。
値
以下の値を 1 つ以上格納した文字列で、スペース区切りです。
"additions"ライブ領域内の要素ノードの追加は、関連性があると考えるべきです。
"removals"ライブ領域からのノードの削除は、関連性があると考えるべきです。
"text"既存のノードのテキストコンテンツの変更は、関連性があるとみなされるべきです。
"all""additions removals text"に相当します。
例
この例では、IDがtext の要素のaria-relevant 属性は "all" に設定されています。ariaRelevant` を使用して値を "text" に更新します。
<div role="timer" aria-live="polite" aria-atomic="true" aria-relevant="all"></div>let el = document.getElementById("clock");console.log(el.ariaRelevant); // allel.ariaRelevant = "text";console.log(el.ariaRelevant); // text