描述
日志是实时区域的一种,新的信息会按有意义的顺序添加,旧的信息可能会消失。例如聊天记录、消息历史、游戏日志或错误日志。与其他实时区域不同,在此角色中,新项目进入日志与读取顺序之间存在关联。日志包含有意义的序列,新信息仅添加到日志末尾,而不是任意位置。
与其他类型的实时区域相比,日志是按顺序排列的,新信息只添加到日志的末尾。当此角色添加到元素时,浏览器会向辅助技术产品发送可访问的日志事件,然后这些产品可以通知用户。
默认情况下,更新仅包含对实时区域的更改,并在用户空闲时宣布。具有 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 |