Skip to content

Commit 6ff7369

Browse files
WilcoFiersJym77
andauthored
Apply suggestions from code review
Co-authored-by: Jean-Yves Moyen <jym@siteimprove.com>
1 parent 3756f02 commit 6ff7369

File tree

1 file changed

+3
-6
lines changed

1 file changed

+3
-6
lines changed

_rules/summary-non-empty-accessible-name-2t702h.md

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -21,11 +21,7 @@ acknowledgments:
2121

2222
## Applicability
2323

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].
2925
- the element has no [explicit role][], or the [explicit role][] is ignored due to a [presentational role conflict][].
3026

3127
## Expectation
@@ -46,7 +42,7 @@ This rule is only applicable to `summary` elements that the browser will use as
4642

4743
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].
4844

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

5147
### Bibliography
5248

@@ -191,5 +187,6 @@ This `summary` element is hidden to everyone.
191187
[included in the accessibility tree]: #included-in-the-accessibility-tree 'Definition of included in the accessibility tree'
192188
[presentational roles conflict resolution]: https://www.w3.org/TR/wai-aria-1.2/#conflict_resolution_presentation_none 'Presentational Roles Conflict Resolution'
193189
[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'
194191
[97a4e1]: https://www.w3.org/WAI/standards-guidelines/act/rules/97a4e1/
195192
[6cfa84]: https://www.w3.org/WAI/standards-guidelines/act/rules/6cfa84/

0 commit comments

Comments
 (0)