aria-relevant

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

描述

ARIA 即時區域 是網頁中的一些區域,當用戶的注意力可能在其他地方時會更新這些區域。當更新在使用者鍵盤焦點之外時,輔助技術(如螢幕閱讀器)會使用即時區域來向用戶報告更新。

即時區域的示例包括新聞字幕、股票行情顯示器、聊天視窗和計分板。這些區域會在沒有使用者互動的情況下更新。一些更新對使用者來說很重要,他們需要了解這些更新。這些更新是相關的。而另一些更新則無關緊要。aria-relevant 用於描述已對 aria-live 區域進行的更改型別,以及哪些更改是相關的,應該進行通報。

該值是一個空格分隔的更改型別列表,包括 additionsremovalstext,其中 all 是這三種類型的簡寫。

當未定義 aria-relevant 時,該值會從具有定義值的最近祖先元素繼承。繼承的值不是累加的;後代元素提供的值會完全覆蓋祖先元素的任何繼承值。當即時區域沒有設定 aria-relevant 屬性,並且沒有設定它的祖先元素時,它會預設設定為 additions text,這意味著元素節點被新增到即時區域內的無障礙樹中,並且文字內容或文字替代被新增到即時區域無障礙樹中的任何後代元素中。這是因為通常文字修改和節點新增是相關的,但節點刪除則無關緊要。

雖然不是支援的值,但如果 none 的值最合適,則它不應是即時區域。

removalsall 的值應謹慎使用。例如,當世界杯中出現進球時,新的比分(新增)很重要,而舊的比分(刪除)則無關緊要。只有當內容刪除代表著重要的更改時,輔助技術才需要被告知內容刪除,例如,當一名球員被換下場時。

additions

元素節點被新增到即時區域內的無障礙樹中。

all

additions removals text 的簡寫。

removals

文字內容、文字替代或即時區域內的元素節點從無障礙樹中刪除。

text

文字內容或文字替代被新增到即時區域無障礙樹中的任何後代元素中。

相關介面

Element.ariaRelevant

作為 Element 介面一部分的 ariaRelevant 屬性反映 aria-relevant 屬性的值。

ElementInternals.ariaRelevant

作為 ElementInternals 介面一部分的 ariaRelevant 屬性反映 aria-relevant 屬性的值。

相關角色

在 **所有** 角色中使用。

規範

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

另請參閱