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
Screen Reader support by expectation
| Expectation | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver for iOS | VoiceOver for macOS |
|---|---|---|---|---|---|---|---|
| MUST convey the presence of aria-model=true | supported | none | supported | partial | none | partial | partial |
| SHOULD limit reading to children of aria-modal=true | supported | none | supported | partial | none | partial | supported |
| SHOULD remove outside content from navigational shortcuts when aria-modal=true | partial | none | supported | partial | none | supported | none |
Voice Control support by expectation
| Expectation | Dragon Naturally Speaking | Voice Access for Android | Voice Control for iOS | Voice 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
| AT | Browser | Has Support |
|---|---|---|
| Dragon Naturally Speaking | Google Chrome | not applicable |
| JAWS | Google Chrome | supported |
| JAWS | Internet Explorer | supported |
| JAWS | Firefox (desktop) | supported |
| Narrator | Microsoft Edge | none |
| NVDA | Google Chrome | supported |
| NVDA | Firefox (desktop) | supported |
| Orca | Firefox (desktop) | partial |
| TalkBack | Google Chrome (android) | none |
| Voice Access for Android | Google Chrome (android) | not applicable |
| Voice Control for iOS | Safari (iOS) | not applicable |
| Voice Control for MacOS | Safari (macOS) | not applicable |
| VoiceOver for iOS | Safari (iOS) | partial |
| VoiceOver for macOS | Safari (macOS) | partial |
This expectation is referenced by 1 tests.
Tests that reference this expectation
| Test name | Screen Reader support | Voice Control support |
|---|---|---|
| APG 1.1 modal dialog example | partial (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
| AT | Browser | Has Support |
|---|---|---|
| Dragon Naturally Speaking | Google Chrome | not applicable |
| JAWS | Google Chrome | supported |
| JAWS | Internet Explorer | supported |
| JAWS | Firefox (desktop) | supported |
| Narrator | Microsoft Edge | none |
| NVDA | Google Chrome | supported |
| NVDA | Firefox (desktop) | supported |
| Orca | Firefox (desktop) | partial |
| TalkBack | Google Chrome (android) | none |
| Voice Access for Android | Google Chrome (android) | not applicable |
| Voice Control for iOS | Safari (iOS) | not applicable |
| Voice Control for MacOS | Safari (macOS) | not applicable |
| VoiceOver for iOS | Safari (iOS) | partial |
| VoiceOver for macOS | Safari (macOS) | supported |
This expectation is referenced by 1 tests.
Tests that reference this expectation
| Test name | Screen Reader support | Voice Control support |
|---|---|---|
| APG 1.1 modal dialog example | partial (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
| AT | Browser | Has Support |
|---|---|---|
| Dragon Naturally Speaking | Google Chrome | not applicable |
| JAWS | Google Chrome | partial |
| JAWS | Internet Explorer | partial |
| JAWS | Firefox (desktop) | partial |
| Narrator | Microsoft Edge | none |
| NVDA | Google Chrome | supported |
| NVDA | Firefox (desktop) | supported |
| Orca | Firefox (desktop) | partial |
| TalkBack | Google Chrome (android) | none |
| Voice Access for Android | Google Chrome (android) | not applicable |
| Voice Control for iOS | Safari (iOS) | not applicable |
| Voice Control for MacOS | Safari (macOS) | not applicable |
| VoiceOver for iOS | Safari (iOS) | supported |
| VoiceOver for macOS | Safari (macOS) | none |
This expectation is referenced by 1 tests.
Tests that reference this expectation
| Test name | Screen Reader support | Voice Control support |
|---|---|---|
| APG 1.1 modal dialog example | partial (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.