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

Test: ARIA dialog role must use document mode

Current support: partial (9/9)

This test ensures the dialog role does not invoke application mode in screen readers. The default mode (document) must be used. ARIA 1.0 had language for the dialog role that could suggest that application mode must be invoked. However, that language was clarified in aria 1.1.

Run this test and and submit your results

On this page

Test HTML

open the test page in a new tab
<!DOCTYPE html>
<html lang="en">
<head>
    <title>ARIA dialog role document mode test</title>
</head>
<body>
    <button>Go to Dialog</button>
    <div role="dialog" aria-label="test">
        <h1 tabindex="-1">Test Dialog</h1>
        <p>paragraph before</p>
        <p id="target">target</p>
        <p>paragraph after</p>
    </div>

    <script>
        /** It is necessary to send focus to an element inside of the dialog in order for some screen readers (NVDA) to read its contents. **/
        document.querySelector('button').addEventListener("click", function(){
           document.querySelector('h1').focus();
        });
    </script>
</body>
</html>

Support tables

Assertions are conditions that must be met for the feature to be considered as "supported". Only "MUST" assertions need to be met for minimal "support". "SHOULD" and "MAY" assertions indicates support that goes above and beyond. Note that there is not an explicit standard that dictates these assertions, and as such, they are likely opinionated. Minimal support reflects that the structure, relationships, and functionality of the feature are conveyed and operable by assistive technology rather than minimal conformance to any specific WCAG SC. As such, a feature might not meet all "MUST" assertions but still be usable (potentially frustratingly so).

Assertion support summary by type of assertion
MUSTSHOULDMAY
partial (9/9)nana

Assertion support summary by assertion

FeatureAssertionSupportHas failing tests
alert roleThe screen reader MUST NOT automatically switch away from reading modepartial (9/9)No

alert role: The screen reader MUST NOT automatically switch away from reading mode

This assertion is from the alert role feature.

ATBrowserHas SupportOutputAction
Dragon Naturally SpeakingInternet Explorernot applicable-More information
JAWS 2018.1808.10Google Chrome 74yes
  • Result: (pass)
    • command: Down arrow
    • Output: target
More information
JAWS 2018.1811.2Internet Explorer 11.253yes
  • Result: (pass)
    • command: Down arrow
    • Output: target
More information
JAWS 2018.1811.2Firefox (desktop) 66yes
  • Result: (pass)
    • command: Down arrow
    • Output: target
More information
Narrator 1809Microsoft Edge 44.17763yes
  • Result: (pass)
    • command: Down arrow
    • Output: target
More information
NVDA 2018.1808.10Google Chrome 74yes
  • Result: (pass)
    • command: down arrow
    • Output: target
More information
NVDA 2018.4.1Firefox (desktop) 64.0.2yes
  • Result: (pass)
    • command: down arrow
    • Output: target
Notes: An element in the dialog had to receive focus before the contents of the dialog would be read by NVDA.
More information
TalkBack 7.2Google Chrome (android) 67yes
  • Result: (pass)
    • command: Swipe right
    • Output: target
More information
VoiceOver for iOS 12.1.2Safari (iOS) 12.1.2yes
  • Result: (pass)
    • command: Swipe Right
    • Output: target
More information
VoiceOver for macOS 10.14.2Safari (macOS) 12.0.2yes
  • Result: (pass)
    • command: VO + Right arrow
    • Output: target
More information

Extended Support for: alert role: The screen reader MUST NOT automatically switch away from reading mode

These are less common combinations

ATBrowserHas SupportOutputAction
Dragon Naturally SpeakingFirefox (desktop)not applicable-More information
Dragon Naturally SpeakingGoogle Chromenot applicable-More information
JAWSMicrosoft Edgeunknown-More information
NarratorFirefox (desktop)unknown-More information
NarratorGoogle Chromeunknown-More information
NarratorInternet Explorerunknown-More information
NVDAInternet Explorerunknown-More information
NVDAMicrosoft Edgeunknown-More information
TalkBackFirefox (desktop)unknown-More information
VoiceOver for iOSGoogle Chrome (ios)unknown-More information
VoiceOver for macOSGoogle Chromeunknown-More information
VoiceOver for macOSFirefox (desktop)unknown-More information

History

  • 2019-01-18 Test created