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/summary-non-empty-accessible-name-2t702h.md
+3-6Lines changed: 3 additions & 6 deletions
Original file line number
Diff line number
Diff line change
@@ -21,11 +21,7 @@ acknowledgments:
21
21
22
22
## Applicability
23
23
24
-
This rule applies to HTML `summary` elements where all of the following are true:
25
-
26
-
- the element is [included in the accessibility tree][]; and
27
-
- the element's [DOM tree][] parent is an HTML `details` element; and
28
-
- the element is the first `summary` element of its siblings; and
24
+
This rule applies to HTML `summary` elements [included in the accessibility tree][] that works as the [summary button for its parent `details` element][details summary].
29
25
- the element has no [explicit role][], or the [explicit role][] is ignored due to a [presentational role conflict][].
30
26
31
27
## Expectation
@@ -46,7 +42,7 @@ This rule is only applicable to `summary` elements that the browser will use as
46
42
47
43
If the `summary` element is not included in the accessibility tree, but is still included in sequential focus navigation, this can result in accessibility issues not tested by this rule. This is covered under [Element with aria-hidden has no content in sequential focus navigation][6cfa84].
48
44
49
-
Note that some user agents expose the `summary` element with a `button` role. This deviates from the implicit ARIA semantics described in [HTML in ARIA](https://www.w3.org/TR/html-aria/#docconformance#el-summary). Because some browsers do not give `summary` elements a button role, these elements need to be tested separately from the [Button has non-empty accessible name](https://www.w3.org/WAI/standards-guidelines/act/rules/97a4e1/) ACT rule.
45
+
Note that some user agents expose the `summary` element with a `button` role. This deviates from the implicit ARIA semantics described in [HTML in ARIA](https://www.w3.org/TR/html-aria/#el-summary). Because some browsers do not give `summary` elements a button role, these elements need to be tested separately from the [Button has non-empty accessible name](https://www.w3.org/WAI/standards-guidelines/act/rules/97a4e1/) ACT rule.
50
46
51
47
### Bibliography
52
48
@@ -191,5 +187,6 @@ This `summary` element is hidden to everyone.
191
187
[included in the accessibility tree]: #included-in-the-accessibility-tree'Definition of included in the accessibility tree'
[semantic role]: #semantic-role'Definition of Semantic Role'
190
+
[details summary]: https://html.spec.whatwg.org/multipage/interactive-elements.html#summary-for-its-parent-details' HTML 5 definition of summary for its parent details'
0 commit comments