WAI-ARIA: Role=Status
Description
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.
Authors SHOULD ensure an element with role status does not receive focus as a result of change in status.
Status is a form of live region. If another part of the page controls what appears in the status, authors SHOULD make the relationship explicit with the aria-controls attribute.
Assistive technologies MAY reserve some cells of a Braille display to render the status.
Elements with the role status have an implicit aria-live value of polite and an implicit aria-atomic value of true.
Screen Reader Support For Role=Status
| 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 |
Role=Status Example
The status role is used to provide advisory information to the user that isn’t important enough for an alert. A role of status has an implicit aria-live value of polite, but this doesn’t necessarily mean it will be announced to the user. Authors can use the aria-live property on the region to override how it’s usually handled by assistive technologies.
<div role="status">
3 new messages in inbox.
</div>Characteristics
Superclass Role
- section
Subclass Roles
- progressbar
- timer
Inherited States and Properties
- aria-atomic
- aria-busy (state)
- aria-controls
- aria-current (state)
- aria-describedby
- aria-details
- aria-disabled (state)
- aria-dropeffect
- aria-errormessage
- aria-expanded (state)
- aria-flowto
- aria-grabbed (state)
- aria-haspopup
- aria-hidden (state)
- aria-invalid (state)
- aria-keyshortcuts
- aria-label
- aria-labelledby
- aria-live
- aria-owns
- aria-relevant
- aria-roledescription
Name From
- author
Implicit Value for Role
- Default for aria-live is polite.
- Default for aria-atomic is true.
Semantic HTML
No HTML element equivalent.
Reference
- WAI-ARIA 1.2 Specification
Refer to the notes from the WAI-ARIA 1.2 specification for more information on role=status. - A11Y Support
The screenreader compatibility for each of the ARIA attributes is taken from the A11Y Support. Please refer to the original source if screenreader compatibility is updated for role=status
