aria-relevant
在 ARIA 实时区域中使用,全局 aria-relevant
属性指示当 无障碍树 在实时区域内修改时,用户代理将触发哪些通知。
描述
ARIA 实时区域 是网页中的一些区域,当用户的注意力可能在其他地方时会更新这些区域。当更新在用户键盘焦点之外时,辅助技术(如屏幕阅读器)会使用实时区域来向用户报告更新。
实时区域的示例包括新闻字幕、股票行情显示器、聊天窗口和计分板。这些区域会在没有用户交互的情况下更新。一些更新对用户来说很重要,他们需要了解这些更新。这些更新是相关的。而另一些更新则无关紧要。aria-relevant
用于描述已对 aria-live
区域进行的更改类型,以及哪些更改是相关的,应该进行通报。
该值是一个空格分隔的更改类型列表,包括 additions
、removals
和 text
,其中 all
是这三种类型的简写。
当未定义 aria-relevant
时,该值会从具有定义值的最近祖先元素继承。继承的值不是累加的;后代元素提供的值会完全覆盖祖先元素的任何继承值。当实时区域没有设置 aria-relevant
属性,并且没有设置它的祖先元素时,它会默认设置为 additions text
,这意味着元素节点被添加到实时区域内的无障碍树中,并且文本内容或文本替代被添加到实时区域无障碍树中的任何后代元素中。这是因为通常文本修改和节点添加是相关的,但节点删除则无关紧要。
虽然不是支持的值,但如果 none
的值最合适,则它不应是实时区域。
removals
和 all
的值应谨慎使用。例如,当世界杯中出现进球时,新的比分(添加)很重要,而旧的比分(删除)则无关紧要。只有当内容删除代表着重要的更改时,辅助技术才需要被告知内容删除,例如,当一名球员被换下场时。
值
相关接口
Element.ariaRelevant
-
作为
Element
接口一部分的ariaRelevant
属性反映aria-relevant
属性的值。 ElementInternals.ariaRelevant
-
作为
ElementInternals
接口一部分的ariaRelevant
属性反映aria-relevant
属性的值。
相关角色
在 **所有** 角色中使用。
规范
规范 |
---|
无障碍富互联网应用程序 (WAI-ARIA) # aria-relevant |