描述
日誌是即時區域的一種,新的資訊會按有意義的順序新增,舊的資訊可能會消失。例如聊天記錄、訊息歷史、遊戲日誌或錯誤日誌。與其他即時區域不同,在此角色中,新專案進入日誌與讀取順序之間存在關聯。日誌包含有意義的序列,新資訊僅新增到日誌末尾,而不是任意位置。
與其他型別的即時區域相比,日誌是按順序排列的,新資訊只新增到日誌的末尾。當此角色新增到元素時,瀏覽器會向輔助技術產品傳送可訪問的日誌事件,然後這些產品可以通知使用者。
預設情況下,更新僅包含對即時區域的更改,並在使用者空閒時宣佈。具有 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 |