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

aria-atomic attribute (aria)

Screen reader support level: partial (44/53)

Voice Control support level: unknown

On this page

About this feature

Indicates whether assistive technologies will present all, or only parts of, the changed region based on the change notifications defined by the aria-relevant attribute.

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 false value by only announcing content that has changedpartial (1/2)partial (2/4)supportedsupportedpartial (1/2)partial (2/4)supportedsupportedpartial (1/2)supportedsupported
MUST convey the true value by announcing all contentsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedpartial (1/2)supportedsupported

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 false value by only announcing content that has changed

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • Screen readers will announce only the changed content within aria-atomic="false".
Screen Reader support for 'MUST convey the false value by only announcing content that has changed'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-atomic test - new nodes are divs applied to: div elementsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported
aria-atomic test - new nodes are spans applied to: div elementnonenonesupportedsupportednonenonesupportedsupportednonesupportedsupported

Expectation: convey the true value by announcing all content

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • Screen readers will announce all the content within aria-atomic="true".