Using the status role

Description

This technique demonstrates how to use the status role and describes the effect it has on browsers and assistive technology.

The status role is a type of live region and a container whose content is advisory information for the user that is not important enough to justify an alert, and is often presented as a status bar. When the role is added to an element, the browser will send out an accessible status event to assistive technology products which can then notify the user about it.

Status information content must be provided within a status object, and it should be ensured that this object does not receive focus.

Assistive technologies may reserve some cells of a Braille display to render the status.

Possible effects on user agents and assistive technology

When the status role is added to an element, or such an element becomes visible, the user agent should do the following:

  • Expose the element as having a status role in the operating system's accessibility API.
  • Fire an accessible status event using the operating system's accessibility API if it supports it.

Assistive technology products should listen for such an event and notify the user accordingly:

  • Screen readers may provide a special key to announce the current status, and this should present the contents of any status live region. These should be announced when the user is idle, unless aria-live="assertive" has been set and in which case the user may be interrupted.
  • Screen magnifiers may enlarge the status.
Note: Opinions may differ on how assistive technology should handle this technique. The information provided above is one of those opinions and therefore not normative.

Examples

Example 1: Adding the status role in HTML

The snippet below shows how the status role is added directly into the HTML source code.

<p role="status">Your changes were automatically saved.</p> 

Working Examples:

Notes

ARIA attributes used

Compatibility

Additional resources