Element: ariaLive プロパティ
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.
ariaLive は Element インターフェイスのプロパティで、要素が更新されることを示す aria-live 属性の値を反映し、ユーザーエージェント、支援技術、ユーザーがライブ領域から期待できる更新の種類を記述します。
値
以下のいずれかの値を持つ文字列です。
"assertive"-
その領域への更新が最も優先度が高く、ユーザーにすぐに表示する必要があることを示します。
"off"-
ユーザーがその領域にフォーカスしていない限り、その領域の更新をユーザーに表示しないことを示します。
"polite"-
現在の文を話し終わるときや、ユーザーが入力するのを一時停止したときなど、次の猶予のある機会に領域を更新することを説明しています。
例
この例では、ID が planetInfo の要素の aria-live 属性は "polite" に設定されています。次に、値を "assertive" に更新します。
html
<div role="region" id="planetInfo" aria-live="polite">
<h2 id="planetTitle">No planet selected</h2>
<p id="planetDescription">Select a planet to view its description</p>
</div>
js
let el = document.getElementById("planetInfo");
console.log(el.ariaLive); // "polite"
el.ariaLive = "assertive";
console.log(el.ariaLive); // assertive
仕様書
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-arialive |