ARIA: log 角色

log 角色用于标识一个元素,该元素创建了一个实时区域,新的信息以有意义的顺序添加,旧的信息可能会消失。

描述

日志是实时区域的一种,新的信息会按有意义的顺序添加,旧的信息可能会消失。例如聊天记录、消息历史、游戏日志或错误日志。与其他实时区域不同,在此角色中,新项目进入日志与读取顺序之间存在关联。日志包含有意义的序列,新信息仅添加到日志末尾,而不是任意位置。

与其他类型的实时区域相比,日志是按顺序排列的,新信息只添加到日志的末尾。当此角色添加到元素时,浏览器会向辅助技术产品发送可访问的日志事件,然后这些产品可以通知用户。

默认情况下,更新仅包含对实时区域的更改,并在用户空闲时宣布。具有 log 角色的元素具有默认的 aria-livepolite。当用户需要在更改时听到整个实时区域的内容时,应设置 aria-atomic="true"。为了尽快进行通知,并且可能打断用户,可以将 aria-live="assertive" 设置为更积极的更新。

关联的 WAI-ARIA 角色、状态和属性

aria-atomic

定义辅助技术是否应呈现更改区域的全部或仅部分内容。具有 log 角色的元素具有默认的 aria-atomicfalse

aria-live

定义辅助技术何时应通知用户有关内容更新的信息。具有 log 角色的元素具有默认的 aria-livepolite,这意味着屏幕阅读器将在用户空闲时宣布日志内的更改。

aria-labelaria-labelledby

log 角色被要求拥有一个可访问的名称。如果存在可见标签,请使用 aria-labelledby,否则请使用 aria-label

最佳实践

对于具有滚动文本的区域(例如股票行情显示器),应使用marquee 角色。

规范

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

另见