Skip to content

Commit 61a8ea8

Browse files
jnurthenmcking65
authored andcommitted
First draft of structural roles guidance section for issue #700 (pull #720)
1 parent e0bc7b1 commit 61a8ea8

File tree

1 file changed

+33
-0
lines changed

1 file changed

+33
-0
lines changed

aria-practices.html

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4496,6 +4496,39 @@ <h2>Roles That Automatically Hide Semantics by Making Their Descendants Presenta
44964496
</p>
44974497
</section>
44984498

4499+
<section id="structural_roles">
4500+
<h2>Structural Roles</h2>
4501+
<p>ARIA provides roles which structure and organize content in a page.
4502+
Generally, if using a host language which provides an element with equivalent semantics,
4503+
authors should avoid using these structural roles unless using the structural role to retrofit
4504+
legacy content when it would be cost prohibitive to alter the underlying DOM.
4505+
@@ Add Web Components use case here @@
4506+
The following structural roles are defined.
4507+
<ul>
4508+
<li>article</li>
4509+
<li>blockquote</li>
4510+
<li>caption</li>
4511+
<li>definition</li>
4512+
<li>directory</li>
4513+
<li>document</li>
4514+
<li>feed</li>
4515+
<li>figure</li>
4516+
<li>group</li>
4517+
<li>heading</li>
4518+
<li>img</li>
4519+
<li>list</li>
4520+
<li>listitem</li>
4521+
<li>math</li>
4522+
<li>note</li>
4523+
<li>paragraph</li>
4524+
<li>separator (when not focusable)</li>
4525+
<li>term</li>
4526+
</ul>
4527+
</p>
4528+
4529+
</section>
4530+
4531+
44994532
<section id="appendices" class="appendix">
45004533
<h2>Appendices</h2>
45014534

0 commit comments

Comments
 (0)