status role (aria)
Screen Reader support level: partial (59/66)
On this page
- About this feature
- Age of results
- Expectations
- announce changes to the live region
- convey the implicit aria-live value of polite by not interrupting the current announcement
- convey the implicit aria-atomic value of true by announcing the entire region
- convey its name and role as part of the live announcement if it has a name
- convey its name and role while navigating the page if it has a name
- Related tests
- Is something not right?
About this feature
A type of live region whose content is advisory information for the user but is not important enough to justify an alert, often but not necessarily presented as a status bar.
Age of results
Results across all tests for this feature range from 3 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 4 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 announce changes to the live region | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
MUST convey the implicit aria-live value of polite by not interrupting the current announcement | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
MUST convey the implicit aria-atomic value of true by announcing the entire region | supported | supported | none | supported | supported | supported | none | none | partial (1/2) | supported | supported |
MAY convey its name and role as part of the live announcement if it has a name | partial | partial | none | partial | partial | partial | none | partial | partial | none | partial |
MAY convey its name and role while navigating the page if it has a name | none | none | none | none | none | none | none | none | partial | none | supported |
Expectation: announce changes to the live region
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- Screen readers will automatically announce the live region.
Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
named status role applied to: div element | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
unnamed status role applied to: div element | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
Expectation: convey the implicit aria-live value of polite by not interrupting the current announcement
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- Screen readers will changes to content within role="status" after other announcements finish.
Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
named status role applied to: div element | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
unnamed status role applied to: div element | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
Expectation: convey the implicit aria-atomic value of true by announcing the entire region
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 role="status".
Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
named status role applied to: div element | supported | supported | none | supported | supported | supported | none | none | none | supported | supported |
unnamed status role applied to: div element | supported | supported | none | supported | supported | supported | none | none | supported | supported | supported |
Expectation: convey its name and role as part of the live announcement if it has a name
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MAY
- Voice Control: NA
Examples:
- Screen readers may announce the name and alert role if it has a name from the author (usually via aria-label or aria-labelledby).
- The name will be announced before or after the contents of the live region.
- The the role will be implied by interruption, or may be explicitly stated as something like "status" or an earcon
Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
named status role applied to: div element | partial | partial | none | partial | partial | partial | none | partial | partial | none | partial |
Expectation: convey its name and role while navigating the page if it has a name
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MAY
- Voice Control: NA
Examples:
- Screen readers may announce the name and role if it has a name from the author (usually via aria-label or aria-labelledby). The name and role are usually announced when navigating into the element.
- screen readers may convey the role as an earcon.
Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
named status role applied to: div element | none | none | none | none | none | none | none | none | partial | none | supported |