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

dialog role (aria)

Screen reader support level: partial (30/40)

Voice Control support level: not applicable

On this page

A dialog is a descendant window of the primary window of a web application. For HTML pages, the primary application window is the entire web document, i.e., the body element.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
MUST convey the dialog rolesupportedsupportedsupportedpartialnonesupportedpartial
MUST convey the name of the dialogsupportedsupportedsupportedpartialnonesupportedpartial
MUST convey the boundaries of the dialogsupportedpartialsupportedpartialnonepartialsupported
MUST NOT automatically switch away from reading modesupportedsupportedsupportedsupportedsupportedsupportedsupported

Voice Control support by expectation

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

Expectation: convey the dialog role

Rationale: Users must be made aware of the dialog context.

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA
Screen Reader support for 'MUST convey the dialog role'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
APG 1.1 modal dialog examplesupportedsupportedsupportedsupportedsupportedsupportedpartialnonesupportedpartial

Expectation: convey the name of the dialog

Rationale: Users need to know the purpose of the dialog.

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA
Screen Reader support for 'MUST convey the name of the dialog'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
APG 1.1 modal dialog examplesupportedsupportedsupportedsupportedsupportedsupportedpartialnonesupportedpartial

Expectation: convey the boundaries of the dialog

Rationale: Users need to know when they enter and exit a dialog.

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA
Screen Reader support for 'MUST convey the boundaries of the dialog'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
APG 1.1 modal dialog examplesupportedsupportedsupportedpartialsupportedsupportedpartialnonepartialsupported

Expectation: automatically switch away from reading mode

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: MUST NOT
  • Voice Control: NA
Screen Reader support for 'MUST NOT automatically switch away from reading mode'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
ARIA dialog role must use document modesupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported