Notice: This is a work in progress. Please submit feedback or suggestions.

alert role (aria)

Screen reader support level: partial (65/79)

Voice Control support level: unknown

On this page

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 5 months ago to a year ago. Detailed dates and version information can be found in associated tests.

Failing and partial results are between a year ago and a year ago.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
MUST announce changes to the live regionsupportedsupportedsupportedsupportedsupportedsupportedsupportednonesupportedsupportedsupported
MUST convey the implicit aria-live value of assertive by interrupting the current announcementnonenonesupportedsupportedsupportedsupportedsupportednonesupportedsupportedsupported
MUST convey the implicit aria-atomic value of true by announcing the entire regionsupportedsupportedsupportedsupportedsupportedsupportedsupportednonepartial (1/2)supportedsupported
MAY convey its name and role as part of the live announcement if it has a namepartialpartialsupportedsupportedpartialpartialsupportednonepartialnonesupported
MAY convey its name and role while navigating the page if it has a namenonenonenonenonenonenonenonepartialpartialnonesupported

Voice Control support by expectation

ExpectationDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech Recognition
ChromeChromeSafariSafariChrome
Not applicable

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.
Screen Reader support for 'MUST announce changes to the live region'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
named alert role applied to: div elementsupportedsupportedsupportedsupportedsupportedsupportedsupportednonesupportedsupportedsupported
unnamed alert role applied to: div elementsupportedsupportedsupportedsupportedsupportedsupportedsupportednonesupportedsupportedsupported

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.
Screen Reader support for 'MUST convey the implicit aria-live value of assertive by interrupting the current announcement'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
named alert role applied to: div elementnonenonesupportedsupportedsupportedsupportedsupportednonesupportedsupportedsupported
unnamed alert role applied to: div elementnonenonesupportedsupportedsupportedsupportedsupportednonesupportedsupportedsupported

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".
Screen Reader support for 'MUST convey the implicit aria-atomic value of true by announcing the entire region'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
named alert role applied to: div elementsupportedsupportedsupportedsupportedsupportedsupportedsupportednonenonesupportedsupported
unnamed alert role applied to: div elementsupportedsupportedsupportedsupportedsupportedsupportedsupportednonesupportedsupportedsupported

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
Screen Reader support for 'MAY convey its name and role as part of the live announcement if it has a name'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
named alert role applied to: div elementpartialpartialsupportedsupportedpartialpartialsupportednonepartialnonesupported

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.
Screen Reader support for 'MAY convey its name and role while navigating the page if it has a name'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
named alert role applied to: div elementnonenonenonenonenonenonenonepartialpartialnonesupported