Element: ariaLive プロパティ

値

以下のいずれかの値を持つ文字列です。

"assertive"

その領域への更新が最も優先度が高く、ユーザーにすぐに表示する必要があることを示します。

"off"

ユーザーがその領域にフォーカスしていない限り、その領域の更新をユーザーに表示しないことを示します。

"polite"

現在の文を話し終わるときや、ユーザーが入力するのを一時停止したときなど、次の猶予のある機会に領域を更新することを説明しています。

例

この例では、ID が planetInfo の要素の aria-live 属性は "polite" に設定されています。次に、値を "assertive" に更新します。

<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>

let el = document.getElementById("planetInfo");
console.log(el.ariaLive); // "polite"
el.ariaLive = "assertive";
console.log(el.ariaLive); // assertive

仕様書

ブラウザーの互換性