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)
# 計時器

另請參見