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

aria-modal attribute (aria)

Screen reader support level: partial (5/10)

Voice Control support level: not applicable

On this page

Indicates whether an element is modal when displayed. For more robust support, consider making the rest of the document inert when an element has aria-modal=true.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver for iOSVoiceOver for macOS
MUST convey the presence of aria-model=truesupportednonesupportedpartialnonepartialpartial
SHOULD limit reading to children of aria-modal=truesupportednonesupportedpartialnonepartialsupported
SHOULD remove outside content from navigational shortcuts when aria-modal=truepartialnonesupportedpartialnonesupportednone

Voice Control support by expectation

ExpectationDragon Naturally SpeakingVoice Access for AndroidVoice Control for iOSVoice Control for MacOS
Not applicable

Expectation: convey the presence of aria-model=true

Rationale: Users need to be aware that other content is obscured by the modal.

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA
ATBrowserHas Support
Dragon Naturally SpeakingGoogle Chromenot applicable
JAWSGoogle Chromesupported
JAWSInternet Explorersupported
JAWSFirefox (desktop)supported
NarratorMicrosoft Edgenone
NVDAGoogle Chromesupported
NVDAFirefox (desktop)supported
OrcaFirefox (desktop)partial
TalkBackGoogle Chrome (android)none
Voice Access for AndroidGoogle Chrome (android)not applicable
Voice Control for iOSSafari (iOS)not applicable
Voice Control for MacOSSafari (macOS)not applicable
VoiceOver for iOSSafari (iOS)partial
VoiceOver for macOSSafari (macOS)partial

This expectation is referenced by 1 tests.

Tests that reference this expectation
Test nameScreen Reader supportVoice Control support
APG 1.1 modal dialog examplepartial (29/40)not applicable

Expectation: limit reading to children of aria-modal=true

Rationale: Users should not be able to access content outside of the modal. However, AT are not required to implement this functionality per the ARIA spec, and authors may implement this on their own.

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: SHOULD
  • Voice Control: NA
ATBrowserHas Support
Dragon Naturally SpeakingGoogle Chromenot applicable
JAWSGoogle Chromesupported
JAWSInternet Explorersupported
JAWSFirefox (desktop)supported
NarratorMicrosoft Edgenone
NVDAGoogle Chromesupported
NVDAFirefox (desktop)supported
OrcaFirefox (desktop)partial
TalkBackGoogle Chrome (android)none
Voice Access for AndroidGoogle Chrome (android)not applicable
Voice Control for iOSSafari (iOS)not applicable
Voice Control for MacOSSafari (macOS)not applicable
VoiceOver for iOSSafari (iOS)partial
VoiceOver for macOSSafari (macOS)supported

This expectation is referenced by 1 tests.

Tests that reference this expectation
Test nameScreen Reader supportVoice Control support
APG 1.1 modal dialog examplepartial (29/40)not applicable

Expectation: remove outside content from navigational shortcuts when aria-modal=true

Rationale: Users should not be able to access content outside of the modal. However, AT are not required to implement this functionality per the ARIA spec, and authors may implement this on their own.

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: SHOULD
  • Voice Control: NA
ATBrowserHas Support
Dragon Naturally SpeakingGoogle Chromenot applicable
JAWSGoogle Chromepartial
JAWSInternet Explorerpartial
JAWSFirefox (desktop)partial
NarratorMicrosoft Edgenone
NVDAGoogle Chromesupported
NVDAFirefox (desktop)supported
OrcaFirefox (desktop)partial
TalkBackGoogle Chrome (android)none
Voice Access for AndroidGoogle Chrome (android)not applicable
Voice Control for iOSSafari (iOS)not applicable
Voice Control for MacOSSafari (macOS)not applicable
VoiceOver for iOSSafari (iOS)supported
VoiceOver for macOSSafari (macOS)none

This expectation is referenced by 1 tests.

Tests that reference this expectation
Test nameScreen Reader supportVoice Control support
APG 1.1 modal dialog examplepartial (29/40)not applicable

Expectation: convey the aria-modal attribute or limit navigation when aria-modal=false

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: MUST NOT
  • Voice Control: NA

No tests reference this expectation yet.