ARIA:计时器角色

timer 角色表示元素是一个数字计数器,列出了从起点开始经过的时间或到终点结束的时间。辅助技术不会宣布对计时器的更新,因为它有一个隐式 aria-live 值为 off

html
<div role="timer" id="eggtimer">0</div>

这将此 div 元素定义为一个没有剩余时间的计时器。

描述

timer 角色表示 Web 内容的这部分是一个实时区域,其中包含一个计时器,列出剩余时间或经过时间。计时器的内部文本应为更新的当前时间测量值。虽然该值不一定需要是机器可解析的,但它应该以规则的间隔持续更新,除非计时器处于暂停状态或到达其终点。

除了 alertlogmarqueestatus 之外,timer 角色也是一个实时区域,可以通过 实时区域 属性进行修改。

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

aria-labelaria-labelledby

某些屏幕阅读器会在宣布计时器元素的内容之前宣布其名称。如果名称可见,请使用 aria-labelledby 进行引用。包含 aria-label 提供了一种方法,可以在屏幕阅读器读取计时器元素内容时,使用未显示的文本为可见内容添加前缀。命名计时器不是必需的,因此,如果两者都不适用,则可以省略这两个属性。

aria-live

具有 timer 角色的元素具有隐式 aria-live 值为 off

可访问性问题

如果需要设置时间限制,例如出于安全原因,用户应该可以选择将其关闭或延长。此限制不适用于时间限制是由于实时事件造成的,例如拍卖或游戏,或者如果完成表单的时间对于有效提交至关重要。

规范

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

另请参见