aria-relevant

在 ARIA 实时区域中使用,全局 aria-relevant 属性指示当 无障碍树 在实时区域内修改时,用户代理将触发哪些通知。

描述

ARIA 实时区域 是网页中的一些区域,当用户的注意力可能在其他地方时会更新这些区域。当更新在用户键盘焦点之外时,辅助技术(如屏幕阅读器)会使用实时区域来向用户报告更新。

实时区域的示例包括新闻字幕、股票行情显示器、聊天窗口和计分板。这些区域会在没有用户交互的情况下更新。一些更新对用户来说很重要,他们需要了解这些更新。这些更新是相关的。而另一些更新则无关紧要。aria-relevant 用于描述已对 aria-live 区域进行的更改类型,以及哪些更改是相关的,应该进行通报。

该值是一个空格分隔的更改类型列表,包括 additionsremovalstext,其中 all 是这三种类型的简写。

当未定义 aria-relevant 时,该值会从具有定义值的最近祖先元素继承。继承的值不是累加的;后代元素提供的值会完全覆盖祖先元素的任何继承值。当实时区域没有设置 aria-relevant 属性,并且没有设置它的祖先元素时,它会默认设置为 additions text,这意味着元素节点被添加到实时区域内的无障碍树中,并且文本内容或文本替代被添加到实时区域无障碍树中的任何后代元素中。这是因为通常文本修改和节点添加是相关的,但节点删除则无关紧要。

虽然不是支持的值,但如果 none 的值最合适,则它不应是实时区域。

removalsall 的值应谨慎使用。例如,当世界杯中出现进球时,新的比分(添加)很重要,而旧的比分(删除)则无关紧要。只有当内容删除代表着重要的更改时,辅助技术才需要被告知内容删除,例如,当一名球员被换下场时。

additions

元素节点被添加到实时区域内的无障碍树中。

all

additions removals text 的简写。

removals

文本内容、文本替代或实时区域内的元素节点从无障碍树中删除。

text

文本内容或文本替代被添加到实时区域无障碍树中的任何后代元素中。

相关接口

Element.ariaRelevant

作为 Element 接口一部分的 ariaRelevant 属性反映 aria-relevant 属性的值。

ElementInternals.ariaRelevant

作为 ElementInternals 接口一部分的 ariaRelevant 属性反映 aria-relevant 属性的值。

相关角色

在 **所有** 角色中使用。

规范

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

另请参阅