aria-atomic attribute (aria)
Screen Reader support level: partial (37/44)
On this page
- About this feature
- Age of results
- Expectations
- Related tests
- Related AT or browser issues
- Is something not right?
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 years ago to 4 years 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 2 years ago. Consider running the associated tests and contributing results.
Expectations
Screen Reader support by expectation
| Expectation | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| MUST convey the false value by only announcing content that has changed | partial (1/2) | partial (1/2) | partial (1/2) | supported | partial (1/2) | partial (1/2) | supported | supported | partial (1/2) | supported | supported |
| MUST convey the true value by announcing all content | supported | supported | supported | supported | supported | supported | supported | supported | partial (1/2) | supported | supported |
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".
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| aria-atomic test - new nodes are divs applied to: div element | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
| aria-atomic test - new nodes are spans applied to: div element | none | none | partial | supported | none | none | supported | supported | none | supported | supported |
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".
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| aria-atomic test - new nodes are divs applied to: div element | supported | supported | supported | supported | supported | supported | supported | supported | none | supported | supported |
| aria-atomic test - new nodes are spans applied to: div element | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |