ARIA: aria-atomic 属性

在 ARIA 实时区域 (live regions) 中,全局 aria-atomic 属性指明辅助技术(例如屏幕阅读器)是会根据 aria-relevant 属性定义的变更通知来呈现整个变更区域,还是只呈现变更区域的一部分。

描述

实时区域是网页中在用户焦点未在该区域时也会更新的部分,无论是用户交互还是其他原因。由于它们在用户焦点之外更新,屏幕阅读器等辅助技术可能无法“看到”更新并将其报告给用户。WAI-ARIA 提供了 4 个属性,允许开发者标识这些实时区域并告知辅助技术如何处理它们,包括 aria-livearia-relevantaria-busyaria-atomic

当实时区域的内容发生变化时,DOM 会从已更改的元素开始,通过其祖先元素进行遍历,以查找第一个 aria-atomic 设置的元素。这将决定应呈现给用户的内容。

如果没有祖先元素显式设置 aria-atomic,则只读取实时区域内容中已更新的节点。省略 aria-atomic 和显式将 ARIA 实时区域的祖先节点设置为 aria-atomic="false" 的区别在于,显式设置 aria-atomic="false" 会阻止屏幕阅读器继续向上查找祖先链。两者都会导致只读取已更新的节点。当设置为 aria-atomic="true" 时,整个变更区域将作为一个整体呈现,包括已更新节点的 label(如果存在)。

false(默认)

仅呈现已更改的节点。

true

整体呈现整个变更区域,包括作者定义的标签(如果存在)。

相关角色

用于 **所有** 角色

规范

规范
无障碍富互联网应用程序 (WAI-ARIA)
# aria-atomic

另见