元素：ariaLive 属性

基线 2023

新可用

自 2023 年 10 月起，此功能在最新的设备和浏览器版本中均可使用。此功能可能在旧版设备或浏览器中无法使用。

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>

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

规范

规范
无障碍富互联网应用 (WAI-ARIA) # dom-ariamixin-arialive

浏览器兼容性

BCD 表格仅在浏览器中加载