ARIA:日志角色
log
角色用于标识创建 实时区域 的元素,在该区域中,新信息以有意义的顺序添加,旧信息可能会消失。
描述
日志是一种实时区域,其中新信息以有意义的顺序添加,旧信息可能会消失。例如,聊天日志、消息历史记录、游戏日志或错误日志。与其他实时区域相比,在这个角色中,日志中新项目的到达与阅读顺序之间存在关系。日志包含有意义的序列,新信息仅添加到日志的末尾,而不是添加到任意位置。
与其他类型的实时区域相比,日志是按顺序排序的,新信息只添加到日志的末尾。当此角色添加到元素时,浏览器将向辅助技术产品发送一个可访问的日志事件,然后辅助技术产品可以通知用户该事件。
默认情况下,更新只包含实时区域的更改,并在用户空闲时进行宣布。具有 log
角色的元素具有 aria-live
值的隐式 polite
。如果用户需要在更改时听到整个实时区域,则应设置 aria-atomic="true"
。为了尽快进行宣布,并且用户可能会被打断,可以设置 aria-live="assertive"
以进行更积极的更新。
关联的 WAI-ARIA 角色、状态和属性
aria-atomic
-
定义辅助技术是否应呈现所有更改区域或仅呈现部分更改区域。具有
log
角色的元素具有 aria-atomic 值的隐式false
。 aria-live
-
定义辅助技术何时应通知用户有关内容更新的信息。具有
log
角色的元素具有 aria-live 值的隐式polite
,这意味着屏幕阅读器将在用户空闲时宣布日志中的更改。 aria-label
和aria-labelledby
-
log
必须具有可访问的名称。如果存在可见标签,请使用aria-labelledby
,否则请使用aria-label
。
最佳实践
对于具有滚动文本的区域(如股票行情走势图),应使用 marquee
角色。
规范
规范 |
---|
可访问的富互联网应用程序 (WAI-ARIA) # log |