Element: ariaLive 属性

Baseline 2023
新推出

自 ⁨2023 年 10 月⁩ 以来,此功能已在最新设备和浏览器版本中得到支持。此功能可能无法在旧设备或浏览器上运行。

Element 接口的 ariaLive 属性反映了 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"

规范

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

浏览器兼容性