ARIA:日誌角色

log 角色用於標識建立 即時區域 的元素,在該區域中,新資訊以有意義的順序新增,舊資訊可能會消失。

描述

日誌是一種即時區域,其中新資訊以有意義的順序新增,舊資訊可能會消失。例如,聊天日誌、訊息歷史記錄、遊戲日誌或錯誤日誌。與其他即時區域相比,在這個角色中,日誌中新專案的到達與閱讀順序之間存在關係。日誌包含有意義的序列,新資訊僅新增到日誌的末尾,而不是新增到任意位置。

與其他型別的即時區域相比,日誌是按順序排序的,新資訊只新增到日誌的末尾。當此角色新增到元素時,瀏覽器將向輔助技術產品傳送一個可訪問的日誌事件,然後輔助技術產品可以通知使用者該事件。

預設情況下,更新只包含即時區域的更改,並在使用者空閒時進行宣佈。具有 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-labelaria-labelledby

log 必須具有可訪問的名稱。如果存在可見標籤,請使用 aria-labelledby,否則請使用 aria-label

最佳實踐

對於具有滾動文字的區域(如股票行情走勢圖),應使用 marquee 角色。

規範

規範
可訪問的富網際網路應用程式 (WAI-ARIA)
# log

另請參閱