aria-activedescendant
aria-activedescendant
属性用于标识焦点位于 composite
微件、combobox
、textbox
、group
或 application
上时当前活动的元素。
描述
aria-activedescendant
属性为辅助技术提供了一种在交互元素包含多个可聚焦后代时(例如菜单、网格和工具栏),进行焦点管理的方法。与屏幕阅读器在拥有的元素之间移动焦点不同,aria-activedescendant
可以在容器元素上使用,引用当前活动的元素,用于在聚焦时向辅助技术用户指示当前活动的元素。
使用 aria-activedescendant
,浏览器会将 DOM 焦点保持在容器元素或控制容器元素的输入元素上。但是,用户代理将桌面聚焦事件和状态发送给辅助技术,就好像 aria-activedescendant
引用的元素具有焦点一样。
此属性仅适用于具有 composite
微件、combobox
、textbox
、group
或 application
角色的元素,其 id
被引用为属性值。
该属性用于为辅助技术提供有关焦点位于哪个元素的信息,但实际上不会创建焦点。使用 JavaScript 来更改焦点并管理属性值。除了管理该属性值之外,确保当前活动的后代在聚焦时可见并在视野内(或滚动到视野内)。
在具有 DOM 焦点的元素上设置 aria-activedescendant
的值时,确保该值引用所拥有的元素——即 DOM 焦点元素的后代或由 aria-owns
属性指示的逻辑后代。
当具有 DOM 焦点的元素是组合框、文本框或搜索框时,请包括 aria-controls
以引用支持 aria-activedescendant
的元素。
aria-activedescendant
的值引用受控元素所拥有的元素。例如,在组合框中,焦点可能仍然位于组合框上,但组合框元素上的 aria-activedescendant
的值引用由组合框控制的弹出列表框的后代。
备注:该属性仅支持少数角色。例如,dialog
不支持 aria-activedescendant
。当组合框打开对话框时,DOM 焦点从组合框移动到对话框,因为它不能通过此属性进行引用。
备注:当焦点位于 listbox
、grid
或 tree
弹出窗口的后代时,DOM 焦点保持在组合框上,并且组合框的 aria-activedescendant
设置为引用弹出窗口内的焦点元素的值。
值
- ID 引用
-
其值为当前具有焦点元素的
id
。
关联角色
仅适用于具有以下角色的元素的属性:
规范
Specification |
---|
Accessible Rich Internet Applications (WAI-ARIA) # aria-activedescendant |
Accessible Rich Internet Applications (WAI-ARIA) # aria-activedescendant |