alert role (aria)
Screen Reader support level: partial (54/66)
On this page
- About this feature
- Age of results
- Expectations
- announce changes to the live region
- convey the implicit aria-live value of assertive by 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 with important, and usually time-sensitive, information. See related alertdialog and status.
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 | none | supported | supported | supported |
| MUST convey the implicit aria-live value of assertive by interrupting the current announcement | none | none | supported | supported | supported | supported | supported | none | partial (1/2) | supported | supported |
| MUST convey the implicit aria-atomic value of true by announcing the entire region | supported | supported | supported | supported | supported | supported | supported | 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 | supported | supported | partial | partial | supported | none | partial | none | supported |
| MAY convey its name and role while navigating the page if it has a name | none | none | none | none | none | none | none | partial | 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 alert role applied to: div element | supported | supported | supported | supported | supported | supported | supported | none | supported | supported | supported |
| unnamed alert role applied to: div element | supported | supported | supported | supported | supported | supported | supported | none | supported | supported | supported |
Expectation: convey the implicit aria-live value of assertive by interrupting the current announcement
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- Screen readers will announce changes to content within role="alert" as soon as those changes are made and interrupt any current announcements, or announce it immediately after the current announcement but before anything else in the announcement queue.
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| named alert role applied to: div element | none | none | supported | supported | supported | supported | supported | none | supported | supported | supported |
| unnamed alert role applied to: div element | none | none | supported | supported | supported | supported | supported | none | none | 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="alert".
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| named alert role applied to: div element | supported | supported | supported | supported | supported | supported | supported | none | none | supported | supported |
| unnamed alert role applied to: div element | supported | supported | supported | supported | supported | supported | supported | 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 "alert" 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 alert role applied to: div element | partial | partial | supported | supported | partial | partial | supported | none | partial | none | supported |
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 alert role applied to: div element | none | none | none | none | none | none | none | partial | partial | none | supported |