Skip to content

Commit 215367e

Browse files
committed
Add paragraph to note that controls must be child nodes of dialogs
#325
1 parent 1197fa6 commit 215367e

File tree

1 file changed

+6
-4
lines changed

1 file changed

+6
-4
lines changed

aria-practices.html

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -502,6 +502,8 @@ <h3>Dialog (Modal)</h3>
502502
That is, <kbd>Tab</kbd> and <kbd>Shift + Tab</kbd> do not move focus outside the dialog.
503503
However, unlike most non-modal dialogs, modal dialogs do not provide means for moving keyboard focus outside the dialog window without closing the dialog.
504504
</p>
505+
<p>For all dialogs, all controls required to operate the dialog are child nodes of the element which has role set to dialog.
506+
</p>
505507
<p>
506508
The <a href="#alertdialog" class="role-reference">alertdialog</a> role is a special-case dialog role
507509
designed specifically for dialogs that divert users' attention to a brief, important message.
@@ -569,11 +571,11 @@ <h4>WAI-ARIA Roles, States, and Properties</h4>
569571
Specifying descriptive elements enables screen readers to announce the description along with the dialog title and initially focused element when the dialog opens.
570572
</li>
571573
<li>
572-
With the addition of <a href="#aria-modal" class="property-reference">aria-modal</a> set to true, where content outside the dialog is completely inert
574+
If the dialog has <a href="#aria-modal" class="property-reference">aria-modal</a> set to <code>true</code>and content outside the dialog is completely inert
573575
and visually obscured to an extent that is intentionally unreadable, it is no longer necessary to set <a href="#aria-hidden" class="state-reference">aria-hidden</a>
574-
to <code>true</code> on each element containing a portion of the inert layer,
575-
If you do still use <code>aria-hidden</code> set to <code>true</code> the dialog container element cannot be a descendant
576-
of an element that has <code>aria-hidden</code> set to <code>true</code> and the content outside the modal dialog must not be visually discernable.
576+
to <code>true</code> on each element containing a portion of the inert layer.
577+
However, if you do still use <code>aria-hidden</code> set to <code>true</code>, the dialog container element cannot be a descendant
578+
of any element that has <code>aria-hidden</code> set to <code>true</code> and the content outside the modal dialog must not be visually discernable.
577579
</li>
578580
</ul>
579581
</section>

0 commit comments

Comments
 (0)