Element: ariaRelevant プロパティ
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.
非標準: この機能は標準ではなく、標準化の予定もありません。公開されているウェブサイトには使用しないでください。ユーザーによっては使用できないことがあります。実装ごとに大きな差があることもあり、将来は振る舞いが変わるかもしれません。
ariaRelevant
は Element
インターフェイスのプロパティで、aria-relevant
属性の値を反映します。この属性は、ライブ領域内のアクセシビリティツリーが変更されたときにユーザーエージェントがどのような通知を発生させるかを示します。これは aria-live
領域内のどのような変更が関連性があり、告知されるべきかを記述するために使用します。
値
以下の値を 1 つ以上格納した文字列で、スペース区切りです。
"additions"
-
ライブ領域内の要素ノードの追加は、関連性があると考えるべきです。
"removals"
-
ライブ領域からのノードの削除は、関連性があると考えるべきです。
"text"
-
既存のノードのテキストコンテンツの変更は、関連性があるとみなされるべきです。
"all"
-
"additions removals text"
に相当します。
例
この例では、IDが text
の要素の aria-relevant
属性は "all" に設定されています。ariaRelevant` を使用して値を "text" に更新します。
<div
id="clock"
role="timer"
aria-live="polite"
aria-atomic="true"
aria-relevant="all"></div>
let el = document.getElementById("clock");
console.log(el.ariaRelevant); // all
el.ariaRelevant = "text";
console.log(el.ariaRelevant); // text