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-labelaria-labelledby

log 必须具有可访问的名称。如果存在可见标签,请使用 aria-labelledby,否则请使用 aria-label

最佳实践

对于具有滚动文本的区域(如股票行情走势图),应使用 marquee 角色。

规范

规范
可访问的富互联网应用程序 (WAI-ARIA)
# log

另请参阅