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.
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.