元素:ariaAtomic 属性

基线 2023

最新可用

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

ariaAtomicElement 接口的属性,它反映了 aria-atomic 属性的值,该属性指示辅助技术是否会根据 aria-relevant 属性定义的更改通知,呈现更改区域的所有内容或仅呈现部分内容。

具有以下值之一的字符串

"false"

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

"true"

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

示例

在本例中,aria-atomic 属性在 ID 为 "clock" 的元素上设置为 "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

浏览器兼容性

BCD 表格仅在浏览器中加载