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

Test: aria-describedby attribute that references role="alert"

Screen Reader support level: partial (5/10)

Voice Control support level: not applicable

This test ensures that the accessible description is computed correctly when aria-describedby references an element with role="alert". See related Firefox bug that suggests that ara-describedby should not include the text in role="alert". This is a common design pattern when error messages update in real time and the author wants to inform screen reader users of those updates.

Run this test and and submit your results

On this page

Test HTML

open the test page
<!DOCTYPE html>
<html lang="en">
<head>
    <title>ARIA describedby with role="alert"</title>
</head>
<body>

<h1>ARIA describedby with role="alert</h1>

<label for="target">Example label</label>
<input id="target" aria-describedby="error" type="text">
<div id="error" role="alert">
    error
</div>

</body>
</html>

Dates and Versions of tested combinations

ATAT VersionBrowserBrowser versionOS versionDate tested
JAWS2018.1811.2Chrome7218092019-03-08
JAWS2018.1811.2IE1118092019-03-08
JAWS2018.1811.2Firefox6018092019-03-08
Narrator1809Edge44.1776318092019-03-08
NVDA2019.2.1Chrome8019092020-02-14
NVDA2019.2.1Firefox7219092020-02-14
Orca3.31.4Firefox69Ubuntu 19.042019-09-16
TalkBack7.3.0Chrome757.02019-07-27
VoiceOver (iOS)12.1.4Safari12.1.412.1.42019-03-08
VoiceOver (macOS)10.14.3Safari12.0.310.14.32019-03-08

Summary of Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
aria-describedby attribute
MUST convey the value if validsupportednonepartial (1/2)partialsupportednonenone

* means that some support is hidden behind settings

Summary of Voice Control support by expectation

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

* means that some support is hidden behind settings

Detailed support results by expectation

Expectation for the aria-describedby attribute: convey the value if valid

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

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

This expectation is from the aria-describedby attribute feature.

ATBrowserHas SupportOutputAction
Dragon Naturally SpeakingChromenot applicable-More information
JAWSChromeyes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: "Example label, edit, error"
More information
JAWSIEyes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: "Example label, edit, error"
More information
JAWSFirefoxyes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: "Example label, edit, error"
More information
NarratorEdgenone
  • Result: (fail)
    • command: Tab (Read next focusable item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: "Example label, editing"
More information
NVDAChromeyes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: "Example label edit error"
More information
NVDAFirefoxnone
  • Result: (fail)
    • command: Tab (Read next focusable item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: "Example label edit has auto complete, blank"
More information
OrcaFirefoxpartial
  • Result: (fail)
    • command: down arrow (Read next item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: "Example label, entry"
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: "Example label, entry, error, focus mode"
More information
TalkBackChromeyes
  • Result: (pass)
    • command: Swipe right (Read next item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: "Edit box, example label, error"
More information
Voice Access (Android)Chromenot applicable-More information
Voice Control (iOS)Safarinot applicable-More information
Voice Control (MacOS)Safarinot applicable-More information
VoiceOver (iOS)Safarinone
  • Result: (fail)
    • command: Swipe Right (Next item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: "Example label, edit text"
More information
VoiceOver (macOS)Safarinone
  • Result: (fail)
    • command: VO + Right arrow (Read next item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: "Example label, edit text"
More information
Windows Speech RecognitionChromenot applicable-More information

Extended Support for: aria-describedby attribute: convey the value if valid

These are less common combinations

ATBrowserHas SupportOutputAction
Dragon Naturally SpeakingIEnot applicable-More information
Dragon Naturally SpeakingFirefoxnot applicable-More information
JAWS 2018.1811.2Edge 44none
  • Result: (fail)
    • command: Tab (Read next focusable item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: "Example label, edit"
More information
NarratorFirefoxunknown-More information
NarratorChromeunknown-More information
NarratorIEunknown-More information
NVDAIEunknown-More information
NVDAEdgeunknown-More information
TalkBackFirefoxunknown-More information
Voice Access (Android)Firefoxnot applicable-More information
VoiceOver (iOS)Chromeunknown-More information
VoiceOver (macOS)Chromeunknown-More information
VoiceOver (macOS)Firefoxunknown-More information
OrcaChromeunknown-More information
Voice Control (MacOS)Chromenot applicable-More information
Voice Control (MacOS)Firefoxnot applicable-More information
Windows Speech RecognitionEdgenot applicable-More information
Back to top

History

  • 2019-02-08 Test created
  • 2019-07-27 Talkback results added
  • 2019-09-16 Add orca results
  • 2020-02-15 retest NVDA with crome and firefox