Skip to content

Commit b805355

Browse files
committed
Modal Dialog Pattern: Add aria-hidden guidance
For issue #325, modified the modal dialog design pattern section of aria-practices.html to add: Optionally, if content outside a dialog is completely inert and visually obscured to an extent that is intentionally unreadable, each element containing a portion of the inert layer has aria-hidden set to true. In this circumstance, the dialog container element cannot be a descendant of an element that has aria-hidden set to true. However, if content outside a modal dialog is visually discernable, aria-hidden is not present.
1 parent ba0a447 commit b805355

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

aria-practices.html

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -568,6 +568,13 @@ <h4>WAI-ARIA Roles, States, and Properties</h4>
568568
element or elements in the dialog contain content that describes the primary purpose or message of the dialog.
569569
Specifying descriptive elements enables screen readers to announce the description along with the dialog title and initially focused element when the dialog opens.
570570
</li>
571+
<li>
572+
Optionally, if content outside a dialog is completely inert and visually obscured to an extent that is intentionally unreadable,
573+
each element containing a portion of the inert layer has
574+
<a href="#aria-hidden" class="state-reference">aria-hidden</a> set to <code>true</code>.
575+
In this circumstance, the dialog container element cannot be a descendant of an element that has <code>aria-hidden</code> set to <code>true</code>.
576+
However, if content outside a modal dialog is visually discernable, aria-hidden is not present.
577+
</li>
571578
</ul>
572579
</section>
573580
<section class="notoc">

0 commit comments

Comments
 (0)