aria-relevant
ARIA ライブリージョンで使用されるグローバルな aria-relevant 属性は、ライブリージョン内の アクセシビリティツリー が変更されたときにユーザーエージェントがトリガーする通知を示します。
解説
ARIA ライブリージョン は、ユーザーの注意が他の場所にある場合に更新されるウェブページの領域です。更新がユーザーのキーボードフォーカスの範囲外にある場合、スクリーンリーダーなどの支援技術はライブリージョン領域を使用してユーザーに更新を報告します。
ライブリージョンの例には、ニュースマーキー、株式相場表示機、チャットウィンドウ、スコアボードなどがあります。これらは、ユーザーの操作なしで更新されます。一部の更新は、ユーザーが知っておくべき重要なものです。関連性があるものもあれば、そうではないものもあります。aria-relevant は、aria-live リージョンにどのような種類の変更が発生したか、およびどの変更が関連性があり、通知する必要があるかを説明するために使用されます。
値は additions、removals、および text を含む変更タイプのスペース区切りのリストであり、省略形である all は 3 つ全てを意味します。
aria-relevant が定義されていない場合、値は値が定義されている最も近い祖先から継承されます。継承された値は追加されるわけではありません。子孫要素に与えられた値は、祖先要素から継承された値を完全に上書きします。ライブリージョンに aria-relevant 属性が設定されておらず、祖先に属性が設定されていない場合、デフォルトで additions text になります。つまり、要素ノードがライブリージョン内のアクセシビリティツリーに追加されることと、テキストコンテンツまたは代替テキストがライブリージョンのアクセシビリティツリー内の子孫に追加されることを意味します。これは、一般にテキストの変更とノードの追加は関連しますが、ノードの削除は関連しないためです。
サポートされている値ではありませんが、none のような値が最も妥当な場合は、ライブリージョンにしないでください。
removals と all の値は、控えめに使用する必要があります。例えばワールドカップでゴールが決まった場合、新しいスコア（追加）は重要ですが、古い値（削除）は重要ではありません。支援技術にコンテンツの削除を通知する必要があるのは、選手が試合から外された場合など、コンテンツの削除が重要な変更を表す場合のみです。
値
関連インターフェイス
Element.ariaRelevant-
Elementインターフェイスの一部であるariaRelevantプロパティは、aria-relevant属性の値を反映します。 ElementInternals.ariaRelevant-
ElementInternalsインターフェイスの一部であるariaRelevantプロパティは、aria-relevant属性の値を反映します。
関連付けられたロール
すべてのロールで使用されます。
仕様書
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # aria-relevant |