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

aria-relevant attribute (aria)

Screen reader support level: partial (16/66)

Voice Control support level: unknown

On this page

About this feature

Indicates what notifications the user agent will trigger when the accessibility tree within a live region is modified. See related aria-relevant.

Age of results

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

Failing and partial results are between a year ago and a year ago.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
MUST convey the 'additions' valuepartialpartialpartialpartialnonenonenonepartialpartialpartialpartial
MUST convey the 'removal' valuepartialpartialnonenonenonenonenonesupportednonenonesupported
MUST convey the 'text' valuepartialpartialpartialnonepartialpartialpartialnonepartialpartialnone
MUST convey the 'all' valuepartialpartialpartialpartialpartialpartialpartialsupportedpartialpartialsupported
MUST convey the 'additions text' combinationsupportedsupportedsupportedpartialsupportedsupportedsupportedsupportedsupportedsupportedsupported

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 'additions' value

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • Screen readers will announce only additions to the DOM within aria-relevant="additions".
Screen Reader support for 'MUST convey the 'additions' value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-relevant attribute applied to: div elementpartialpartialpartialpartialnonenonenonepartialpartialpartialpartial

Expectation: convey the 'removal' value

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • Screen readers will announce only removals to the DOM within aria-relevant="removals".
Screen Reader support for 'MUST convey the 'removal' value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-relevant attribute applied to: div elementpartialpartialnonenonenonenonenonesupportednonenonesupported

Expectation: convey the 'text' value

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • Screen readers will announce only text changes to existing nodes within aria-relevant="text".
Screen Reader support for 'MUST convey the 'text' value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-relevant attribute applied to: div elementpartialpartialpartialnonepartialpartialpartialnonepartialpartialnone

Expectation: convey the 'all' value

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • Screen readers will announce additions, removals, and text changes to within aria-relevant="all".
Screen Reader support for 'MUST convey the 'all' value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-relevant attribute applied to: div elementpartialpartialpartialpartialpartialpartialpartialsupportedpartialpartialsupported

Expectation: convey the 'additions text' combination

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • Screen readers will announce only additions to the DOM and text changes to existing nodes within aria-relevant="additions text".
Screen Reader support for 'MUST convey the 'additions text' combination'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-relevant attribute applied to: div elementsupportedsupportedsupportedpartialsupportedsupportedsupportedsupportedsupportedsupportedsupported