Notice: This is a work in progress. Please submit feedback or suggestions.

aria-activedescendant attribute (aria)

Screen reader support level: partial (23/25)

Voice Control support level: unknown

On this page

About this feature

Identifies the currently active element when DOM focus is on a composite widget, textbox, group, or application.

Age of results

Results across all tests for this feature range from a month ago to a year ago. Detailed dates and version information can be found in associated tests.

Caution

Failing or partial results may be out of date. The oldest result is from a year ago. Consider running the associated tests and contributing results.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
MUST convey the referenced element as activesupportedsupportedsupportednonesupportedsupportedsupportedsupportedsupportedsupportedsupported
MUST convey when the referenced element changessupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportednot applicablenot applicablesupported

Voice Control support by expectation

ExpectationDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech Recognition
ChromeChromeSafariSafariChrome
Not applicable

Expectation: convey the referenced element as active

Rationale:

A screen reader user needs to be aware of which descendant is currently active

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • When navigating to an element with this attribute, screen readers will also announce the referenced element

Expectation: convey when the referenced element changes

Rationale:

A screen reader user needs to be aware of which descendant is currently active

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • When navigating within an element with this attribute, screen readers will also announce the referenced element as the reference changes