aria-relevant attribute (aria)
Screen Reader support level: partial (15/55)
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 years ago to 5 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 'additions' value | partial | partial | partial | partial | none | none | none | partial | partial | partial | partial |
| MUST convey the 'removal' value | partial | partial | none | none | none | none | none | none | none | supported | supported |
| MUST convey the 'text' value | partial | partial | partial | none | partial | partial | partial | partial | partial | none | none |
| MUST convey the 'all' value | partial | partial | partial | partial | partial | partial | partial | partial | partial | supported | supported |
| MUST convey the 'additions text' combination | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
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".
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| aria-relevant attribute applied to: div element | partial | partial | partial | partial | none | none | none | partial | partial | partial | partial |
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".
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".
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".
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| aria-relevant attribute applied to: div element | partial | partial | partial | partial | partial | partial | partial | partial | partial | supported | supported |
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".
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| aria-relevant attribute applied to: div element | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |