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
。
关联角色
仅在具有以下角色的元素上作为属性相关
规范
规范 |
---|
可访问的富互联网应用程序 (WAI-ARIA) # aria-activedescendant |
可访问的富互联网应用程序 (WAI-ARIA) # aria-activedescendant |