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