大网数据广告活动
Web 标准与前端开发

aria-atomic

· 52CE 我爱测

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

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

描述

实时区域是网页的部分,在用户焦点在其他地方时更新,无论是通过用户交互还是其他方式。由于它们在用户焦点之外更新,因此辅助技术(如屏幕阅读器)可能无法“看到”更新并将其报告给用户。WAI-ARIA 有 4 个属性,允许开发人员识别这些实时区域并告诉辅助技术如何处理它们,包括 aria-live、aria-relevant、aria-busy 和 aria-atomic。

当实时区域的内容发生更改时,DOM 从更改的元素经过其祖先以找到首个设置了 aria-atomic 的元素。这确定了应该向用户呈现的内容。

如果没有祖先明确设置了 aria-atomic,则仅读取已更新的实时区域内容的节点或节点。省略 aria-atomic 和显式设置 ARIA 实时区域的祖先节点的差异在于,显式设置 aria-atomic="false" 会阻止屏幕阅读器上溯祖先链。两者都导致仅读取更新的节点。当设置为 aria-atomic="true" 时,将呈现整个更改的区域,包括更新的节点的 label(如果存在)。

值

  • false(默认)
    • : 仅呈现更改的节点或节点。
  • true
    • : 呈现整个更改的区域,包括作者定义的标签(如果存在)。

关联角色

适用于所有角色。

规范

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。