Skip to content

Commit dfe62bf

Browse files
authored
clarify that modal requires an accessible name (#1180)
The use of the word "label" is confusing, and dialogs require an accessible name. That is a MUST, not a SHOULD.
1 parent 8420961 commit dfe62bf

File tree

1 file changed

+1
-1
lines changed

1 file changed

+1
-1
lines changed

index.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -2828,7 +2828,7 @@ <h2>Definition of Roles</h2>
28282828
<div class="role-description">
28292829
<p>A dialog is a descendant window of the primary window of a web application. For <abbr title="Hypertext Markup Language">HTML</abbr> pages, the primary application window is the entire web document, i.e., the <code>body</code> element.</p>
28302830
<p>Dialogs are most often used to prompt the user to enter or respond to information. A dialog that is designed to interrupt workflow is usually modal. See related <rref>alertdialog</rref>.</p>
2831-
<p>Authors SHOULD provide a dialog label, which can be done with the <pref>aria-label</pref> or <pref>aria-labelledby</pref> attribute.</p>
2831+
<p>Authors MUST provide an accessible name for a dialog, which can be done with the <pref>aria-label</pref> or <pref>aria-labelledby</pref> attribute.</p>
28322832
<p>Authors SHOULD ensure that all dialogs (both modal and non-modal) have at least one focusable descendant element. Authors SHOULD focus an element in the modal dialog when it is displayed, and authors SHOULD manage focus of modal dialogs.</p>
28332833
<p class="note">In the description of this role, the term "web application" does not refer to the <rref>application</rref> role, which specifies specific assistive technology behaviors.</p>
28342834
</div>

0 commit comments

Comments
 (0)