aria-atomic

在 ARIA 即時區域中,全域性 aria-atomic 屬性指示輔助技術(如螢幕閱讀器)是否會根據 aria-relevant 屬性定義的更改通知,呈現所有更改的區域或僅呈現部分割槽域。

描述

即時區域是網頁中的部分內容,它們會更新,無論是透過使用者互動還是其他方式,即使使用者焦點在其他地方也是如此。由於它們在使用者焦點之外更新,因此輔助技術(如螢幕閱讀器)可能無法“看到”更新,從而無法向用戶報告更新。WAI-ARIA 有 4 個屬性,允許開發人員識別這些即時區域並告知輔助技術如何處理它們,包括 aria-livearia-relevantaria-busyaria-atomic

當即時區域的內容發生變化時,DOM 會從更改的元素遍歷其祖先,以查詢第一個設定了 aria-atomic 的元素。這將確定應向用戶呈現的內容。

如果祖先沒有顯式設定 aria-atomic,則只會讀取即時區域內容中已更新的節點或節點。顯式設定 aria-atomic="false" 與完全省略 aria-atomic 之間的區別在於,顯式設定 aria-atomic="false" 會阻止螢幕閱讀器向上遍歷祖先鏈。兩者都會導致僅讀取更新的節點。當設定為 aria-atomic="true" 時,整個更改區域作為一個整體將被呈現,包括更新節點的 label(如果有)。

false (預設)

僅呈現更改的節點或節點。

true

呈現整個更改區域作為一個整體,包括作者定義的標籤(如果存在)。

相關角色

用於所有 角色.

規範

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

另請參閱