aria-activedescendant

aria-activedescendant 屬性在焦點位於 composite 小部件、comboboxtextboxgroupapplication 時,標識當前活動的元素。

描述

aria-activedescendant 屬性提供了一種方法,用於在互動式元素包含多個可聚焦的後代(例如選單、網格和工具欄)時,為輔助技術管理這些後代的焦點。螢幕閱讀器無需在擁有的元素之間移動焦點,aria-activedescendant 可以用於容器元素來引用當前活動的元素,從而在聚焦時通知輔助技術使用者當前活動的元素。

使用 aria-activedescendant,瀏覽器會將 DOM 焦點保持在容器元素或控制容器元素的輸入元素上。但是,使用者代理會將桌面焦點事件和狀態傳達給輔助技術,就好像 aria-activedescendant 引用的元素具有焦點一樣。

此屬性僅與角色為 composite 小部件、comboboxtextboxgroupapplication 的元素相關,其 id 作為屬性值引用。

該屬性負責向輔助技術提供有關哪個元素具有焦點的的資訊,但它本身不會建立焦點。焦點的更改和屬性值的管理是透過 JavaScript 完成的。除了管理該屬性值之外,還要確保當前活動的子元素在聚焦時可見且位於視野中(或滾動到視野中)。

在具有 DOM 焦點的元素上設定 aria-activedescendant 的值時,請確保該值引用一個擁有的元素——要麼是具有 DOM 焦點的元素的後代,要麼是 aria-owns 屬性指示的邏輯後代。

當具有 DOM 焦點的元素是組合框、文字框或搜尋框時,請包含 aria-controls 以引用支援 aria-activedescendant 的元素。

aria-activedescendant 的值引用受控元素的擁有元素。例如,在組合框中,焦點可能會保留在組合框上,而組合框元素上的 aria-activedescendant 的值則引用組合框控制的彈出列表框的後代。

注意:該屬性僅在少數幾個角色上受支援。例如,dialog 不支援 aria-activedescendant。當組合框開啟對話方塊時,DOM 焦點會從組合框移動到對話方塊中,因為它無法透過此屬性進行引用。

注意:listboxgridtree 彈出視窗的後代獲得焦點時,DOM 焦點會保留在組合框上,並且組合框的 aria-activedescendant 設定為一個值,該值引用彈出視窗中獲得焦點的元素。

ID 引用

以其值為當前聚焦元素的 id

關聯角色

僅在具有以下角色的元素上作為屬性相關

規範

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