You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: _rules/role-required-states-and-properties-4e8ab6.md
+7-6Lines changed: 7 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,6 +24,7 @@ input_aspects:
24
24
acknowledgments:
25
25
authors:
26
26
- Anne Thyme Nørregaard
27
+
- Tom Brunet
27
28
funding:
28
29
- WAI-Tools
29
30
---
@@ -38,21 +39,19 @@ For each test target, the [WAI-ARIA required states and properties][] for the ro
38
39
39
40
## Assumptions
40
41
41
-
- The applicability of this rule is limited to [explicit semantic roles][explicit semantic role] based on an assumption that all native HTML and SVG elements have native attributes that are mapped to all of the [WAI-ARIA required states and properties](https://www.w3.org/TR/wai-aria/#requiredState) for the [implicit semantic role][] of the element.
42
-
43
-
- The ARIA `role` is being used to comply to WCAG.
42
+
- The ARIA `role` is being used to conform to WCAG.
44
43
45
44
## Accessibility Support
46
45
47
-
This rule relies on browsers and assistive technologies to support leaving out [WAI-ARIA required states and properties][] when a [WAI-ARIA implicit value for role][] is specified in [WAI-ARIA Specifications](#wai-aria-specifications).
46
+
This rule relies on browsers and assistive technologies to support leaving out [WAI-ARIA required states and properties][] when a [WAI-ARIA implicit value for role][] is specified in [WAI-ARIA Specifications][].
48
47
49
48
**Note:** The required states and properties with implicit values can be found in the Core Accessibility API Mappings 1.1 [Overview of default values for missing required attributes](https://www.w3.org/TR/core-aam-1.1/#authorErrorDefaultValuesTable).
50
49
51
50
## Background
52
51
53
-
Omitting required ARIA properties is often the result of a developer error. When required properties are missing some browsers and assistive technologies will guess the property, or leave the element inaccessible.
52
+
Omitting [WAI-ARIA required states and properties][] is often the result of a developer error. When required properties are missing and a default value is not specified by [WAI-ARIA Specifications][], the behavior is not defined. For [WAI-ARIA 1.2][], the only [explicit semantic roles][explicit semantic role] with a required property with a default value are the `option` and `tabs roles` for the `aria-selected` property.
54
53
55
-
This rule is testing author built components, not user-agent built ones. Elements that keep their [implicit semantic role][] are mapped into conforming accessible objects, with all required properties, by user agents and are therefore not tested by this rule. Most of these mappings are defined in the [HTML Accessibility API Mappings, Attribute State and Property Mappings](https://www.w3.org/TR/html-aam-1.0/#html-attribute-state-and-property-mappings).
54
+
This rule is testing author built components that specify [explicit semantic roles][explicit semantic role] and not components that keep their [implicit semantic role][]. For components that keep their [implicit semantic role][], all native HTML and SVG elements have native attributes that are mapped to all of the [WAI-ARIA required states and properties](https://www.w3.org/TR/wai-aria/#requiredState). Most of these mappings are defined in the [HTML Accessibility API Mappings, Attribute State and Property Mappings][htmlaam].
56
55
57
56
### Bibliography
58
57
@@ -221,9 +220,11 @@ This `combobox` is not [included in the accessibility tree][] due to its styling
221
220
```
222
221
223
222
[explicit semantic role]: #explicit-role'Definition of explicit semantic role'
223
+
[html aam]: https://www.w3.org/TR/html-aam-1.0/#html-attribute-state-and-property-mappings'Specification of HTML attributes value mapping to ARIA states and properties'
224
224
[implicit semantic role]: #implicit-role'Definition of implicit semantic role'
225
225
[included in the accessibility tree]: #included-in-the-accessibility-tree'Definition of Included in The Accessibility Tree'
226
226
[wai-aria required states and properties]: https://www.w3.org/TR/wai-aria-1.2/#requiredState
227
+
[wai-aria specifications]: #wai-aria-specifications'Definition of WAI-ARIA Specifications'
227
228
[wai-aria implicit value for role]: https://www.w3.org/TR/wai-aria-1.2/#implictValueForRole
0 commit comments