ARIA: aria-relevant 屬性

在 ARIA 即時區域中使用的全域性 aria-relevant 屬性指示當即時區域內的 輔助功能樹 修改時,使用者代理將觸發哪些通知。

描述

ARIA 即時區域 是網頁中在使用者注意力可能不在其他地方時進行更新的區域。當更新超出使用者的鍵盤焦點時,螢幕閱讀器等輔助技術會使用即時區域來向用戶報告更新。

即時區域的示例包括新聞跑馬燈、股票行情、聊天視窗和記分牌。這些內容會在沒有使用者互動的情況下更新。其中一些更新對使用者很重要。它們是相關的。其他則不重要。aria-relevant 用於描述對 aria-live 區域所發生更改的型別,以及哪些更改是相關的並且應該被播報。

該值是以空格分隔的更改型別列表,包括 additions(新增)、removals(移除)和 text(文字),以及表示全部三者的簡寫 all

aria-relevant 未定義時,其值將從最近一個定義了該值的祖先元素繼承。繼承的值不是累加的;在子代元素上提供的值將完全覆蓋來自祖先元素的任何繼承值。當一個即時區域沒有設定 aria-relevant 屬性,並且沒有一個祖先元素設定了該屬性時,它將預設設定為 additions text,這意味著元素節點被新增到即時區域內的輔助功能樹中,並且文字內容或文字替代項被新增到即時區域輔助功能樹的任何子代中。這是因為通常文字修改和節點新增是相關的,而節點移除則不相關。

雖然 none 不是一個支援的值,但如果它的含義最合適,那麼它就不應該被視為一個即時區域。

removalsall 的值應該謹慎使用。例如,當世界杯發生進球時,新的比分(新增)很重要,而舊的比分(移除)則不重要。只有當內容移除代表一個重要變化時,輔助技術才需要被告知內容被移除,例如當一個玩家被從比賽中移除時。

additions

元素節點被新增到即時區域內的輔助功能樹中。

all

additions removals text 的簡寫。

removals

即時區域內的文字內容、文字替代項或元素節點從輔助功能樹中移除。

文字

文字內容或文字替代項被新增到即時區域輔助功能樹的任何子代中。

相關介面

Element.ariaRelevant

ariaRelevant 屬性是 Element 介面的一部分,它反映了 aria-relevant 屬性的值。

ElementInternals.ariaRelevant

ariaRelevant 屬性是 ElementInternals 介面的一部分,它反映了 aria-relevant 屬性的值。

相關角色

用於 **所有** 角色。

規範

規範
無障礙富網際網路應用程式 (WAI-ARIA)
# aria-relevant

另見