aria-atomic

在 ARIA 实时区域中,全局 aria-atomic 属性指示辅助技术(如屏幕阅读器)是否会根据 aria-relevant 属性定义的更改通知,呈现所有更改的区域或仅呈现部分区域。

描述

实时区域是网页中的部分内容,它们会更新,无论是通过用户交互还是其他方式,即使用户焦点在其他地方也是如此。由于它们在用户焦点之外更新,因此辅助技术(如屏幕阅读器)可能无法“看到”更新,从而无法向用户报告更新。WAI-ARIA 有 4 个属性,允许开发人员识别这些实时区域并告知辅助技术如何处理它们,包括 aria-livearia-relevantaria-busyaria-atomic

当实时区域的内容发生变化时,DOM 会从更改的元素遍历其祖先,以查找第一个设置了 aria-atomic 的元素。这将确定应向用户呈现的内容。

如果祖先没有显式设置 aria-atomic,则只会读取实时区域内容中已更新的节点或节点。显式设置 aria-atomic="false" 与完全省略 aria-atomic 之间的区别在于,显式设置 aria-atomic="false" 会阻止屏幕阅读器向上遍历祖先链。两者都会导致仅读取更新的节点。当设置为 aria-atomic="true" 时,整个更改区域作为一个整体将被呈现,包括更新节点的 label(如果有)。

false (默认)

仅呈现更改的节点或节点。

true

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

相关角色

用于所有 角色.

规范

规范
可访问富互联网应用程序 (WAI-ARIA)
# aria-atomic

另请参阅