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

Test: ARIA alertdialog role must use document mode

Current support: supported

This test ensures the alertdialog role does not invoke application mode in screen readers. The default mode (document) must be used. ARIA 1.0 had language for the alertdialog 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 alertdialog role document mode test</title>
</head>
<body>
<button>Go to Dialog</button>
<div role="alertdialog" 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>

Dates and Versions of tested combinations

ATAT VersionBrowserBrowser versionOS versionDate tested
JAWS2018.1808.10Google Chrome7418092019-05-19
JAWS2018.1811.2Internet Explorer11.25318092019-01-19
JAWS2018.1811.2Firefox (desktop)6618092019-05-19
Narrator1809Microsoft Edge44.1776318092018-01-18
NVDA2018.1808.10Google Chrome7418092019-05-19
NVDA2018.4.1Firefox (desktop)64.0.218092019-01-19
TalkBack7.2Google Chrome (android)678.12018-07-21
VoiceOver for iOS12.1.2Safari (iOS)12.1.212.1.22018-01-18
VoiceOver for macOS10.14.2Safari (macOS)12.0.210.14.22018-10-26
Orca3.31.4Firefox (desktop)69Ubuntu 19.042019-09-13

Summary of support by expectation and assistive technology

ExpectationDragon Naturally SpeakingJAWSNarratorNVDATalkBackVoiceOver for iOSVoiceOver for macOSOrca
alertdialog role
MUST NOT automatically switch away from reading modenot applicablesupportedsupportedsupportedsupportedsupportedsupportedsupported

* means that some support is hidden behind settings

Detailed support results by expectation

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

Grading method: Just one of the listed commands must pass for the expectation to pass.

This expectation is from the alertdialog role feature.

ATBrowserHas SupportOutputAction
Dragon Naturally SpeakingGoogle Chromenot applicable-More information
JAWSGoogle Chromeyes
  • Result: (pass)
    • command: Down arrow (Read next item)
    • location before command: before target
    • location after command: target
    • Output: target
More information
JAWSInternet Exploreryes
  • Result: (pass)
    • command: Down arrow (Read next item)
    • location before command: before target
    • location after command: target
    • Output: target
More information
JAWSFirefox (desktop)yes
  • Result: (pass)
    • command: Down arrow (Read next item)
    • location before command: before target
    • location after command: target
    • Output: target
More information
NarratorMicrosoft Edgeyes
  • Result: (pass)
    • command: Down arrow (Read next item (scan mode))
    • location before command: before target
    • location after command: target
    • Output: target
More information
NVDAGoogle Chromeyes
  • Result: (pass)
    • command: down arrow (Read next item)
    • location before command: before target
    • location after command: target
    • Output: target
More information
NVDAFirefox (desktop)yes
  • Result: (pass)
    • command: down arrow (Read next item)
    • location before command: before target
    • location after command: target
    • 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
TalkBackGoogle Chrome (android)yes
  • Result: (pass)
    • command: Swipe right (Read next item)
    • location before command: before target
    • location after command: target
    • Output: target
More information
VoiceOver for iOSSafari (iOS)yes
  • Result: (pass)
    • command: Swipe Right (Next item)
    • location before command: before target
    • location after command: target
    • Output: target
More information
VoiceOver for macOSSafari (macOS)yes
  • Result: (pass)
    • command: VO + Right arrow (Read next item)
    • location before command: before target
    • location after command: target
    • Output: target
More information
OrcaFirefox (desktop)yes
  • Result: (pass)
    • command: down arrow (Read next item)
    • location before command: before target
    • location after command: target
    • Output: "target"
More information

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

These are less common combinations

ATBrowserHas SupportOutputAction
Dragon Naturally SpeakingInternet Explorernot applicable-More information
Dragon Naturally SpeakingFirefox (desktop)not 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 (Android)unknown-More information
VoiceOver for iOSGoogle Chrome (ios)unknown-More information
VoiceOver for macOSGoogle Chromeunknown-More information
VoiceOver for macOSFirefox (desktop)unknown-More information
OrcaGoogle Chromeunknown-More information
Back to top

History

  • 2019-01-18 Test created
  • 2019-09-13 Orca results and missing information added

This test is found in the following features:

Feedback and Contribute

We use our GitHub repository to manage our issue tracking. Please provide as much information as you can for issues, and please leave the id in the issue title intact.

Other

What are expectations and how are they determined?