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

另見