aria-activedescendant property provides a method of managing focus for assistive technologies on interactive elements when they contain multiple focusable descendants, such as menus, grids, and toolbars. Instead of the screen reader moving focus between owned elements,
aria-activedescendant can be used on container elements to refer to the currently active element, informing assistive technology users of the currently active element when focused.
With aria-activedescendant, the browser keeps the DOM focus on the container element or on an input element that controls the container element. However, the user agent communicates desktop focus events and states to the assistive technology as if the element referenced by
aria-activedescendant has focus.
In setting the value of
aria-activedescendant on an element with DOM focus, ensure the value refers to an owned element—either a descendant of the element with DOM focus OR a logical descendant as indicated by the
When the element with DOM focus is a combobox, textbox, or searchbox, include
aria-controls to refer to the element that supports
The value of
aria-activedescendant refers to an owned element of the controlled element. For example, in a combobox, focus may remain on the combobox while the value of
aria-activedescendant on the combobox element refers to a descendant of a popup listbox that is controlled by the combobox.
Note: The attribute is supported only on a few roles. For example,
dialogs do not support
aria-activedescendant. When a combobox opens a dialog, DOM focus moves into the dialog from the combobox as it is not referenceable with this attribute.
Note: When a descendant of a listbox, grid, or tree popup is focused, DOM focus remains on the combobox and the combobox has aria-activedescendant set to a value that refers to the focused element within the popup.
- ID reference
takes as its value the
idof the currently focused element.
Relevant only as an attribute on elements with the following roles: