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

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

Current support: partial (4/9)

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 in a new tab
<!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>

Support tables

Expectations are conditions that must be met for the feature to be considered as "supported". Only "MUST" expectations need to be met for minimal "support". "SHOULD" and "MAY" expectations indicates support that goes above and beyond. Note that there is not an explicit standard that dictates these expectations, and as such, they are likely opinionated. As such, a feature might not meet all "MUST" expectations but still be usable (potentially frustratingly so). Additionally, the assistive technology may provide many different commands to read, navigate, or otherwise interact with a feature. Only one command is required to pass for the expectation to be minimally supported.

Summary of support by expectation type

MUSTSHOULDMAY
partial (4/9)

Summary of support by expectation and assistive technology

ExpectationDragon Naturally SpeakingJAWSNarratorNVDATalkBackVoiceOver for iOSVoiceOver for macOS
aria-describedby attribute
MUST convey the value if validnot applicablesupportednoneno known supportsupportednonenone

* means that some support is hidden behind settings

Detailed support results by expectation

aria-describedby attribute: The screen reader MUST convey the value if valid

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 SpeakingGoogle Chromenot applicable-More information
JAWSGoogle Chromeyes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • Output: Example label, edit, error
More information
JAWSInternet Exploreryes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • Output: Example label, edit, error
More information
JAWSFirefox (desktop)yes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • Output: Example label, edit, error
More information
NarratorMicrosoft Edgenone
  • Result: (fail)
    • command: Tab (Read next focusable item)
    • Output: Example label, editing
More information
NVDAGoogle Chromeunknown-More information
NVDAFirefox (desktop)none
  • Result: (fail)
    • command: Tab (Read next focusable item)
    • Output: Example label edit has auto complete
More information
TalkBackGoogle Chrome (android)yes
  • Result: (pass)
    • command: Swipe right (Read next item)
    • Output: "Edit box, example label, error"
More information
VoiceOver for iOSSafari (iOS)none
  • Result: (fail)
    • command: Swipe Right (Next item)
    • Output: Example label, edit text
More information
VoiceOver for macOSSafari (macOS)none
  • Result: (fail)
    • command: VO + Right arrow (Read next item)
    • Output: Example label, edit text
More information

Extended Support for: aria-describedby attribute: The screen reader MUST convey the value if valid

These are less common combinations

ATBrowserHas SupportOutputAction
Dragon Naturally SpeakingInternet Explorernot applicable-More information
Dragon Naturally SpeakingFirefox (desktop)not applicable-More information
JAWS 2018.1811.2Microsoft Edge 44none
  • Result: (fail)
    • command: Tab (Read next focusable item)
    • Output: Example label, edit
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
Back to top

Dates and Versions

ATAT VersionBrowserBrowser versionOS versionDate tested
JAWS2018.1811.2Google Chrome7218092019-03-08
JAWS2018.1811.2Internet Explorer1118092019-03-08
JAWS2018.1811.2Firefox (desktop)6018092019-03-08
Narrator1809Microsoft Edge44.1776318092019-03-08
NVDA2018.4.1Firefox (desktop)65.0.218042019-03-08
TalkBack7.3.0Google Chrome (android)757.02019-07-27
VoiceOver for iOS12.1.4Safari (iOS)12.1.412.1.42019-03-08
VoiceOver for macOS10.14.3Safari (macOS)12.0.310.14.32019-03-08

History

  • 2019-02-08 Test created
  • 2019-07-27 Talkback results added