ARIA: aria-relevant 属性

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

描述

ARIA 实时区域 是网页中在用户注意力可能不在其他地方时进行更新的区域。当更新超出用户的键盘焦点时,屏幕阅读器等辅助技术会使用实时区域来向用户报告更新。

实时区域的示例包括新闻跑马灯、股票行情、聊天窗口和记分牌。这些内容会在没有用户交互的情况下更新。其中一些更新对用户很重要。它们是相关的。其他则不重要。aria-relevant 用于描述对 aria-live 区域所发生更改的类型,以及哪些更改是相关的并且应该被播报。

该值是以空格分隔的更改类型列表,包括 additions(添加)、removals(移除)和 text(文本),以及表示全部三者的简写 all

aria-relevant 未定义时,其值将从最近一个定义了该值的祖先元素继承。继承的值不是累加的;在子代元素上提供的值将完全覆盖来自祖先元素的任何继承值。当一个实时区域没有设置 aria-relevant 属性,并且没有一个祖先元素设置了该属性时,它将默认设置为 additions text,这意味着元素节点被添加到实时区域内的辅助功能树中,并且文本内容或文本替代项被添加到实时区域辅助功能树的任何子代中。这是因为通常文本修改和节点添加是相关的,而节点移除则不相关。

虽然 none 不是一个支持的值,但如果它的含义最合适,那么它就不应该被视为一个实时区域。

removalsall 的值应该谨慎使用。例如,当世界杯发生进球时,新的比分(添加)很重要,而旧的比分(移除)则不重要。只有当内容移除代表一个重要变化时,辅助技术才需要被告知内容被移除,例如当一个玩家被从比赛中移除时。

additions

元素节点被添加到实时区域内的辅助功能树中。

all

additions removals text 的简写。

removals

实时区域内的文本内容、文本替代项或元素节点从辅助功能树中移除。

文本

文本内容或文本替代项被添加到实时区域辅助功能树的任何子代中。

相关接口

Element.ariaRelevant

ariaRelevant 属性是 Element 接口的一部分,它反映了 aria-relevant 属性的值。

ElementInternals.ariaRelevant

ariaRelevant 属性是 ElementInternals 接口的一部分,它反映了 aria-relevant 属性的值。

相关角色

用于 **所有** 角色。

规范

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

另见