Skip to content

Commit bf16983

Browse files
authored
Clarify role and attributes for summary element (#560)
closes #553 updates the note in the implicit role column for the summary element to be more accurate to the current reality of how a summary is exposed by UAs and AT. additionally, this PR updates the wording to clarify the condition for when a summary can have any role (e.g., when used incorrectly).
1 parent 181421a commit bf16983

File tree

1 file changed

+5
-4
lines changed

1 file changed

+5
-4
lines changed

index.html

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3117,22 +3117,23 @@ <h2 id="docconformance">
31173117
<a>No corresponding role</a>
31183118
</p>
31193119
<div class="note">
3120-
Many, but not all, user agents expose the `summary` element with an implicit ARIA
3121-
<code>role=<a href="#index-aria-button">button</a></code>.
3120+
The exposed role of a `summary` element can vary depending on the user agent and assistive technology.
31223121
</div>
31233122
</td>
31243123
<td>
31253124
<div class="proposed correction">
31263125
<p>
31273126
<a><strong class="nosupport">No `role`</strong></a> if the `summary` element is a
3128-
<a data-cite="html/interactive-elements.html#summary-for-its-parent-details">summary for its parent details</a>.
3127+
<a data-cite="html/interactive-elements.html#summary-for-its-parent-details">summary for its parent details</a> element.
31293128
</p>
31303129
<p>
31313130
<a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a>,
31323131
`aria-disabled`, and `aria-haspopup` attributes.
31333132
</p>
31343133
<p>
3135-
Otherwise, authors MAY specifiy <a><strong>Any `role`</strong></a>, and any
3134+
Otherwise, if the `summary` element is <strong>not</strong> a
3135+
<a data-cite="html/interactive-elements.html#summary-for-its-parent-details">summary for its parent details</a>
3136+
element, authors MAY specifiy <a><strong>any `role`</strong></a>, and any
31363137
<a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a>
31373138
and any `aria-*` attributes applicable to the allowed roles.
31383139
</p>

0 commit comments

Comments
 (0)