元素:ariaAtomic 属性

Baseline 2023
新推出

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

Element 接口的 ariaAtomic 属性反映了 aria-atomic 属性的值,该属性指示辅助技术是根据 aria-relevant 属性定义的变更通知来呈现变更区域的全部内容,还是只呈现部分内容。

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

"false"

辅助技术将只呈现已更改的节点。

"true"

辅助技术将把整个已更改区域作为一个整体呈现,包括作者定义的标签(如果存在)。

示例

在此示例中,ID 为 "clock" 的元素的 aria-atomic 属性设置为 "true"。我们使用 ariaAtomic 将其值更新为 "false"。

html
<div id="clock" role="timer" aria-live="polite" aria-atomic="true"></div>
js
let el = document.getElementById("clock");
console.log(el.ariaAtomic); // true
el.ariaAtomic = "false";
console.log(el.ariaAtomic); // false

规范

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

浏览器兼容性