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-label和aria-labelledby-
log必須具有可訪問的名稱。如果存在可見標籤,請使用aria-labelledby,否則請使用aria-label。
最佳實踐
對於具有滾動文字的區域(如股票行情走勢圖),應使用 marquee 角色。
規範
| 規範 |
|---|
| 可訪問的富網際網路應用程式 (WAI-ARIA) # log |