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

Test: aria-required attribute on role=radiogroup

Current support: partial (28/36)

Tests the aria-required attribute against a suite of examples.

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-required examples</title>
</head>
<body>
<h1>aria-required examples</h1>
<p>This page contains an aria radio group with aria-requried set</p>

<h2>aria-required="true" on role="radiogroup"</h2>
<div role="radiogroup" aria-labelledby="animal-legend" aria-required="true">
    <h3 id="animal-legend">Animal</h3>
    <input type="radio" name="animal" value="cat" id="cat"><label for="cat">Cat</label>
    <input type="radio" name="animal" value="dog" id="dog"><label for="dog">Dog</label>
</div>

<button>submit</button>

</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.

Expectation support summary by type of expectation

MUSTSHOULDMAY
partial (28/36)

Expectation support summary by expectation

FeatureExpectationSupportHas failing tests
aria-required attributeThe screen reader MUST convey the "true" valuepartial (7/9)Yes
radiogroup roleThe screen reader MUST convey the group rolepartial (7/9)Yes
radiogroup roleThe screen reader MUST convey the group name if it has a group namepartial (7/9)Yes
radiogroup roleThe screen reader MUST convey the boundaries of the grouppartial (7/9)Yes

aria-required attribute: The screen reader MUST convey the "true" value

This expectation is from the aria-required attribute feature.

ATBrowserHas SupportOutputAction
Dragon Naturally SpeakingInternet Explorernot applicable-More information
JAWS 2019.1906.10Google Chrome 75yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: target
    • Output: "animal, required, cat radio button, not checked, 1 of 2"
More information
JAWS 2019.1906.10Internet Explorer 11yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: target
    • Output: "animal, required, cat radio button, not checked"
More information
JAWS 2019.1906.10Firefox (desktop) 67yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: target
    • Output: "animal, required, cat radio button, not checked, 1 of 2"
More information
Narrator 1903Microsoft Edge 44.17763none
  • Result: (fail)
    • command: Tab
    • location before command: before target
    • location after command: target
    • Output: "Animal. Cat. Radio button. Non selected. 1 of 2."
More information
NVDA 2019.1.1Google Chrome 75yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: target
    • Output: "Animal grouping required. Cat radio button. Checked, 1 of 2."
More information
NVDA 2019.1.1Firefox (desktop) 67yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: target
    • Output: "Animal grouping required. Cat radio button. Checked, 1 of 2."
More information
TalkBackGoogle Chrome (android)unknown-More information
VoiceOver for iOS 12.3.1Safari (iOS) 12.3.1yes
  • Result: (pass)
    • command: Swipe Right
    • location before command: before target
    • location after command: target
    • Output: "cat, radio button, unchecked, 1 of 2, required."
More information
VoiceOver for macOS 10.14.5Safari (macOS) 12.1.1yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: target
    • Output: "cat, radio button, 1 of 2, Animal, required, radio group."
More information

Extended Support for: aria-required attribute: The screen reader MUST convey the "true" value

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 (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

radiogroup role: The screen reader MUST convey the group role

Rationale: A screen reader user needs to be aware that elements are within a group

Examples of assistive technologies support this expectation:

  • The role name is announced when entering the group.
  • If focus is outside of the group, then the accessible name of the group is announced when focus jumps to a control within the group.

This expectation is from the radiogroup role feature.

ATBrowserHas SupportOutputAction
Dragon Naturally SpeakingInternet Explorernot applicable-More information
JAWS 2019.1906.10Google Chrome 75yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: within target
    • Output: "animal, required, cat radio button, not checked, 1 of 2"
  • Result: (pass)
    • command: Down arrow
    • location before command: before target
    • location after command: start of target
    • Output: "group start, animal"
  • Result: (pass)
    • command: Up arrow
    • location before command: after target
    • location after command: end of target
    • Output: "group end"
More information
JAWS 2019.1906.10Internet Explorer 11yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: within target
    • Output: "animal, required, cat radio button, not checked, 1 of 2"
  • Result: (pass)
    • command: Down arrow
    • location before command: before target
    • location after command: start of target
    • Output: "group start, animal"
  • Result: (pass)
    • command: Up arrow
    • location before command: after target
    • location after command: end of target
    • Output: "group end"
More information
JAWS 2019.1906.10Firefox (desktop) 67yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: within target
    • Output: "animal, required, cat radio button, not checked, 1 of 2"
  • Result: (pass)
    • command: Down arrow
    • location before command: before target
    • location after command: start of target
    • Output: "group start, animal"
  • Result: (pass)
    • command: Up arrow
    • location before command: after target
    • location after command: end of target
    • Output: "group end"
More information
Narrator 1903Microsoft Edge 44.17763yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: within target
    • Output: "Animal. Cat. Radio button. Non selected. 1 of 2."
  • Result: (pass)
    • command: Down arrow
    • location before command: before target
    • location after command: start of target
    • Output: "Selected. Requires selection. Contains 2 items. Required. Heading level 3. Animal."
  • Result: (pass)
    • command: Up arrow
    • location before command: after target
    • location after command: end of target
    • Output: "Selected. Requires selection. Contains 2 items. Required. Heading level 3. Dog."
Notes: Reading mode passed because "Contains 2 items" implies a grouping
More information
NVDA 2019.1.1Google Chrome 75yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: within target
    • Output: "Animal grouping required. Cat radio button. Checked, 1 of 2."
  • Result: (fail)
    • command: down arrow
    • location before command: before target
    • location after command: start of target
    • Output: "Heading level 3 Animal"
  • Result: (pass)
    • command: up arrow
    • location before command: after target
    • location after command: end of target
    • Output: "radio button not checked. clickable Cat. radio button not checked. clickable. Dog."
More information
NVDA 2019.1.1Firefox (desktop) 67yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: within target
    • Output: "Animal grouping required. Cat radio button. Checked, 1 of 2."
  • Result: (fail)
    • command: down arrow
    • location before command: before target
    • location after command: start of target
    • Output: "Heading level 3 Animal"
  • Result: (pass)
    • command: up arrow
    • location before command: after target
    • location after command: end of target
    • Output: "radio button not checked. clickable Cat. radio button not checked. clickable. Dog."
More information
TalkBackGoogle Chrome (android)unknown-More information
VoiceOver for iOS 12.3.1Safari (iOS) 12.3.1none
  • Result: (fail)
    • command: Swipe Right
    • location before command: within target
    • location after command: within target
    • Output: "Cat, radio button, unchecked, 1 of 2, required"
  • Result: (fail)
    • command: Swipe Right
    • location before command: before target
    • location after command: start of target
    • Output: "Animal, Heading level 3, required"
  • Result: (fail)
    • command: Swipe Left
    • location before command: after target
    • location after command: end of target
    • Output: "Dog. Radio button, unchecked, 2 of 2, required"
More information
VoiceOver for macOS 10.14.5Safari (macOS) 12.1.1yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: within target
    • Output: "Cat, radio button, 1 of 2, Animal, radio group."
  • Result: (pass)
    • command: VO + Right arrow
    • location before command: before target
    • location after command: start of target
    • Output: "Animal. Required. Radio group."
  • Result: (pass)
    • command: VO + Left Arrow
    • location before command: after target
    • location after command: end of target
    • Output: "End of Animal. Required. Radio group."
More information

Extended Support for: radiogroup role: The screen reader MUST convey the group role

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 (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

radiogroup role: The screen reader MUST convey the group name if it has a group name

Rationale: A screen reader user needs to be aware of the name of group

Examples of assistive technologies support this expectation:

  • The accessible name of the group is announced when entering the group.

This expectation is from the radiogroup role feature.

ATBrowserHas SupportOutputAction
Dragon Naturally SpeakingInternet Explorernot applicable-More information
JAWS 2019.1906.10Google Chrome 75yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: within target
    • Output: "animal, required, cat radio button, not checked, 1 of 2"
  • Result: (pass)
    • command: Down arrow
    • location before command: before target
    • location after command: start of target
    • Output: "group start, animal"
  • Result: (fail)
    • command: Up arrow
    • location before command: after target
    • location after command: end of target
    • Output: "group end"
More information
JAWS 2019.1906.10Internet Explorer 11yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: within target
    • Output: "animal, required, cat radio button, not checked, 1 of 2"
  • Result: (pass)
    • command: Down arrow
    • location before command: before target
    • location after command: start of target
    • Output: "group start, animal"
  • Result: (fail)
    • command: Up arrow
    • location before command: after target
    • location after command: end of target
    • Output: "group end"
More information
JAWS 2019.1906.10Firefox (desktop) 67yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: within target
    • Output: "animal, required, cat radio button, not checked, 1 of 2"
  • Result: (pass)
    • command: Down arrow
    • location before command: before target
    • location after command: start of target
    • Output: "group start, animal"
  • Result: (fail)
    • command: Up arrow
    • location before command: after target
    • location after command: end of target
    • Output: "group end"
More information
Narrator 1903Microsoft Edge 44.17763yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: within target
    • Output: "Animal. Cat. Radio button. Non selected. 1 of 2."
More information
NVDA 2019.1.1Google Chrome 75yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: within target
    • Output: "Animal grouping required. Cat radio button. Checked, 1 of 2."
More information
NVDA 2019.1.1Firefox (desktop) 67yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: within target
    • Output: "Animal grouping required. Cat radio button. Checked, 1 of 2."
More information
TalkBackGoogle Chrome (android)unknown-More information
VoiceOver for iOS 12.3.1Safari (iOS) 12.3.1none
  • Result: (fail)
    • command: Swipe Right
    • location before command: within target
    • location after command: within target
    • Output: "Cat, radio button, unchecked, 1 of 2, required"
  • Result: (fail)
    • command: Swipe Right
    • location before command: before target
    • location after command: start of target
    • Output: "Animal, Heading level 3, required"
  • Result: (fail)
    • command: Swipe Left
    • location before command: after target
    • location after command: end of target
    • Output: "Dog. Radio button, unchecked, 2 of 2, required"
More information
VoiceOver for macOS 10.14.5Safari (macOS) 12.1.1yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: within target
    • Output: "Cat, radio button, 1 of 2, Animal, radio group."
  • Result: (pass)
    • command: VO + Right arrow
    • location before command: before target
    • location after command: start of target
    • Output: "Animal. Required. Radio group."
  • Result: (pass)
    • command: VO + Left Arrow
    • location before command: after target
    • location after command: end of target
    • Output: "End of Animal. Required. Radio group."
More information

Extended Support for: radiogroup role: The screen reader MUST convey the group name if it has a group name

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 (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

radiogroup role: The screen reader MUST convey the boundaries of the group

Rationale: A screen reader user needs to be aware when they enter and exit a group

Examples of assistive technologies support this expectation:

  • In reading mode, there might be a stop for both the start end end of the group. When entering the group, something like "group name, group" might be announced. When leaving the group, something like "end of group" might be announced.
  • In reading mode, there might not be a stop for the start and end of the group. In this case, the screen reader might announce the group name when the user navigates to the first child and announce that the user is leaving the group when the user navigates out of the group.
  • In interaction mode, there will not be a stop for the start and end of the group. In this case, the screen reader might announce the group name when the user jumps to an interactive child and announce that the user is leaving the group when the user jumps out of the group.

This expectation is from the radiogroup role feature.

ATBrowserHas SupportOutputAction
Dragon Naturally SpeakingInternet Explorernot applicable-More information
JAWS 2019.1906.10Google Chrome 75yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: within target
    • Output: "animal, required, cat radio button, not checked, 1 of 2"
  • Result: (pass)
    • command: Down arrow
    • location before command: before target
    • location after command: start of target
    • Output: "group start, animal"
  • Result: (pass)
    • command: Up arrow
    • location before command: after target
    • location after command: end of target
    • Output: "group end"
More information
JAWS 2019.1906.10Internet Explorer 11yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: within target
    • Output: "animal, required, cat radio button, not checked, 1 of 2"
  • Result: (pass)
    • command: Down arrow
    • location before command: before target
    • location after command: start of target
    • Output: "group start, animal"
  • Result: (pass)
    • command: Up arrow
    • location before command: after target
    • location after command: end of target
    • Output: "group end"
More information
JAWS 2019.1906.10Firefox (desktop) 67yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: within target
    • Output: "animal, required, cat radio button, not checked, 1 of 2"
  • Result: (pass)
    • command: Down arrow
    • location before command: before target
    • location after command: start of target
    • Output: "group start, animal"
  • Result: (pass)
    • command: Up arrow
    • location before command: after target
    • location after command: end of target
    • Output: "group end"
More information
Narrator 1903Microsoft Edge 44.17763yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: within target
    • Output: "Animal. Cat. Radio button. Non selected. 1 of 2."
  • Result: (pass)
    • command: Down arrow
    • location before command: before target
    • location after command: start of target
    • Output: "Selected. Requires selection. Contains 2 items. Required. Heading level 3. Animal."
  • Result: (pass)
    • command: Up arrow
    • location before command: after target
    • location after command: end of target
    • Output: "Selected. Requires selection. Contains 2 items. Required. Heading level 3. Dog."
Notes: Reading mode passed because "Contains 2 items" implies a grouping
More information
NVDA 2019.1.1Google Chrome 75yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: within target
    • Output: "Animal grouping required. Cat radio button. Checked, 1 of 2."
  • Result: (fail)
    • command: down arrow
    • location before command: before target
    • location after command: start of target
    • Output: "Heading level 3 Animal"
  • Result: (fail)
    • command: down arrow
    • location before command: within target
    • location after command: after target
    • Output: "Button. Submit."
  • Result: (fail)
    • command: up arrow
    • location before command: after target
    • location after command: end of target
    • Output: "radio button not checked. clickable Cat. radio button not checked. clickable. Dog."
More information
NVDA 2019.1.1Firefox (desktop) 67yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: within target
    • Output: "Animal grouping required. Cat radio button. Checked, 1 of 2."
  • Result: (fail)
    • command: down arrow
    • location before command: before target
    • location after command: start of target
    • Output: "Heading level 3 Animal"
  • Result: (fail)
    • command: down arrow
    • location before command: within target
    • location after command: after target
    • Output: "Button. Submit."
  • Result: (fail)
    • command: up arrow
    • location before command: after target
    • location after command: end of target
    • Output: "radio button not checked. clickable Cat. radio button not checked. clickable. Dog."
More information
TalkBackGoogle Chrome (android)unknown-More information
VoiceOver for iOS 12.3.1Safari (iOS) 12.3.1none
  • Result: (fail)
    • command: Swipe Right
    • location before command: within target
    • location after command: within target
    • Output: "Cat, radio button, unchecked, 1 of 2, required"
  • Result: (fail)
    • command: Swipe Right
    • location before command: before target
    • location after command: start of target
    • Output: "Animal, Heading level 3, required"
  • Result: (fail)
    • command: Swipe Left
    • location before command: after target
    • location after command: end of target
    • Output: "Dog. Radio button, unchecked, 2 of 2, required"
More information
VoiceOver for macOS 10.14.5Safari (macOS) 12.1.1yes
  • Result: (pass)
    • command: Tab
    • location before command: before target
    • location after command: within target
    • Output: "Cat, radio button, 1 of 2, Animal, radio group."
  • Result: (pass)
    • command: VO + Right arrow
    • location before command: before target
    • location after command: start of target
    • Output: "Animal. Required. Radio group."
  • Result: (pass)
    • command: VO + Left Arrow
    • location before command: after target
    • location after command: end of target
    • Output: "End of Animal. Required. Radio group."
More information

Extended Support for: radiogroup role: The screen reader MUST convey the boundaries of the group

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 (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

History

  • 2019-07-01 Test created