ElementInternals: ariaLive 属性

Baseline 2023
新推出

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

ElementInternals 接口的 ariaLive 属性反映了 aria-live 属性的值,该属性指示元素将要更新,并描述了用户代理、辅助技术和用户可以从实时区域期望的更新类型。

注意:ElementInternals 上设置 ARIA 属性允许为自定义元素定义默认语义。这些默认语义可能会被作者定义的属性覆盖,但可以确保在作者删除或根本未添加这些属性时,默认语义仍然保留。有关更多信息,请参阅 Accessibility Object Model explainer

一个字符串,其值可能为以下之一:

"assertive"

指示区域的更新具有最高优先级,应立即呈现给用户。

"off"

指示除非用户当前将焦点放在该区域,否则不应将该区域的更新呈现给用户。

"polite"

表示该区域的更新应在下一次合适的机会呈现,例如在说完当前句子时或用户暂停输入时。

示例

在此示例中,ariaLive 的值设置为 "assertive"。

js
class CustomControl extends HTMLElement {
  constructor() {
    super();
    this.internals_ = this.attachInternals();
    this.internals_.ariaLive = "assertive";
  }
  // …
}

规范

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

浏览器兼容性