このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
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" aria-live="polite"> <h2>No planet selected</h2> <p>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 |