Skip to content

Commit a9934e7

Browse files
scottaoharacarmacleod
authored andcommitted
remove allowance of group in lists (#1053)
* removes allowance of `group` within `list` * changes notes and examples that referred to `list` and `group`s containing `listitem`s to instead reference `listbox` and `group`s containing `option`s, as that is a similar, allowed pattern. changes affect content of: * Required Owned Elements * group role * list role * listitem role * remove reference to groups in directories
1 parent 8de9304 commit a9934e7

File tree

2 files changed

+7
-12
lines changed

2 files changed

+7
-12
lines changed

common/acknowledgements/aria-wg-active.html

+1
Original file line numberDiff line numberDiff line change
@@ -36,5 +36,6 @@ <h4>Participants active in the ARIA WG at the time of publication</h4>
3636
<li>Job van Achterberg (Invited Expert)</li>
3737
<li>Evan Yamanishi (W. W. Norton)</li>
3838
<li>Jason White (Educational Testing Service)</li>
39+
<li>Scott O'Hara (The Paciello Group, LLC)</li>
3940
</ul>
4041
</section>

index.html

+6-12
Original file line numberDiff line numberDiff line change
@@ -503,11 +503,11 @@ <h3>Required Owned Elements</h3>
503503
<dt>Values</dt>
504504
<dd>Any valid <abbr title="Resource Description Framework">RDF</abbr> object reference, such as a <abbr title="Uniform Resource Identifier">URI</abbr>.</dd>
505505
</dl>
506-
<p>Any <a>element</a> that will be <a>owned</a> by the element with this <a>role</a>. For example, an element with the role <rref>list</rref> will own at least one element with the role <rref>group</rref> or <rref>listitem</rref>.</p>
506+
<p>Any <a>element</a> that will be <a>owned</a> by the element with this <a>role</a>. For example, an element with the role <rref>list</rref> will own at least one element with the role <rref>listitem</rref>.</p>
507507
<p>When multiple roles are specified as <em>required owned elements</em> for a role, at least one instance of one required owned element is expected. This specification does <em>not</em> require an instance of each of the listed owned roles. For example, a <code>menu</code> should have at least one instance of a <code>menuitem</code>, <code>menuitemcheckbox</code>, <em>or</em> <code>menuitemradio</code>. The <code>menu</code> role does not require one instance of each. </p>
508508
<p>There may be times that required owned elements are missing, for example, while editing or while loading a data set. When a widget is missing <em>required owned elements</em> due to script execution or loading, authors MUST mark a containing element with <sref>aria-busy</sref> equal to <code>true</code>. For example, until a page is fully initialized and complete, an author could mark the document element as busy.</p>
509509
<p class="note">A role that has 'required owned elements' does not imply the reverse relationship. While processing of a role may be incomplete without elements of given roles present as descendants, elements with roles in this list do not always have to be found within elements of the given role. See <a href="#scope">required context role</a> for requirements about the context where elements of a given role will be contained.</p>
510-
<p class="note">An element with a <a href="#subclassroles">subclass role</a> of the 'required owned element' does not fulfill this requirement. For example, the <rref>list</rref> role requires ownership of an element using either the <rref>listitem</rref> or <rref>group</rref> role. Although the <rref>group</rref> role is the superclass of <rref>row</rref>, adding a owned element with a role of <rref>row</rref> will not fulfill the requirement that <rref>list</rref> must own a <rref>listitem</rref> or a <rref>group</rref>.</p>
510+
<p class="note">An element with a <a href="#subclassroles">subclass role</a> of the 'required owned element' does not fulfill this requirement. For example, the <rref>listbox</rref> role requires ownership of an element using the <rref>option</rref> or <rref>group</rref> role. Although the <rref>group</rref> role is the superclass of <rref>row</rref>, adding a owned element with a role of <rref>row</rref> will not fulfill the requirement that <rref>listbox</rref> must own a <rref>option</rref> or a <rref>group</rref>.</p>
511511
<p class="note">An element with the appropriate <a href="#implicit_semantics">implicit WAI-ARIA semantic</a> fulfills this requirement.</p>
512512
</section>
513513
<section id="scope">
@@ -3572,7 +3572,7 @@ <h2>Definition of Roles</h2>
35723572
<div class="role-description">
35733573
<p>A set of user interface <a>objects</a> that is not intended to be included in a page summary or table of contents by <a>assistive technologies</a>.</p>
35743574
<p>Contrast with <rref>region</rref>, which is a grouping of user interface objects that will be included in a page summary or table of contents.</p>
3575-
<p>Authors SHOULD use a <code>group</code> to form a logical collection of items in a <a>widget</a>, such as children in a tree widget forming a collection of siblings in a hierarchy, or a collection of items having the same container in a directory. However, when a <code>group</code> is used in the context of a <rref>list</rref>, authors MUST limit its children to <rref>listitem</rref> elements. Therefore, proper handling of <code>group</code> by authors and assistive technologies is determined by the context in which it is provided.</p>
3575+
<p>Authors SHOULD use a <code>group</code> to form a logical collection of items in a <a>widget</a>, such as children in a tree widget forming a collection of siblings in a hierarchy. However, when a <code>group</code> is used in the context of a <rref>listbox</rref>, authors MUST limit its children to <rref>option</rref> elements. Therefore, proper handling of <code>group</code> by authors and assistive technologies is determined by the context in which it is provided.</p>
35763576
<p>Authors MAY nest <code>group</code> elements. If a section is significant enough to warrant inclusion in the web page's table of contents, the author SHOULD assign it a <a>role</a> of <rref>region</rref> or a <a href="#landmark_roles">standard landmark role</a>.</p>
35773577
</div>
35783578
<table class="role-features">
@@ -4346,7 +4346,7 @@ <h2>Definition of Roles</h2>
43464346
<rdef>list</rdef>
43474347
<div class="role-description">
43484348
<p>A <rref>section</rref> containing <rref>listitem</rref> elements. See related <rref>listbox</rref>.</p>
4349-
<p>Lists contain children whose <a>role</a> is <rref>listitem</rref>, or elements whose <a>role</a> is <rref>group</rref> which in turn contains children whose <a>role</a> is <rref>listitem</rref>.</p>
4349+
<p>Lists contain children whose <a>role</a> is <rref>listitem</rref>.</p>
43504350
</div>
43514351
<table class="role-features">
43524352
<caption>Characteristics:</caption>
@@ -4388,12 +4388,7 @@ <h2>Definition of Roles</h2>
43884388
</tr>
43894389
<tr>
43904390
<th class="role-mustcontain-head" scope="row">Required Owned Elements:</th>
4391-
<td class="role-mustcontain">
4392-
<ul>
4393-
<li><rref>group</rref> <abbr title="containing" class="symbol">→</abbr> <rref>listitem</rref></li>
4394-
<li><rref>listitem</rref></li>
4395-
</ul>
4396-
</td>
4391+
<td class="role-mustcontain"><rref>listitem</rref></td>
43974392
</tr>
43984393
<tr>
43994394
<th class="role-required-properties-head">Required States and Properties:</th>
@@ -4544,7 +4539,7 @@ <h2>Definition of Roles</h2>
45444539
<rdef>listitem</rdef>
45454540
<div class="role-description">
45464541
<p>A single item in a list or directory.</p>
4547-
<p>Authors MUST ensure <a>elements</a> whose <a>role</a> is <code>listitem</code> are contained in, or owned by, an <a>element</a> whose <a>role</a> is <rref>list</rref>, or an <a>element</a> whose <a>role</a> is <rref>group</rref> which in turn is contained or owned by an <a>element</a> whose <a>role</a> is <rref>list</rref>.</p>
4542+
<p>Authors MUST ensure <a>elements</a> whose <a>role</a> is <code>listitem</code> are contained in, or owned by, an <a>element</a> whose <a>role</a> is <rref>list</rref>.</p>
45484543
</div>
45494544
<table class="role-features">
45504545
<caption>Characteristics:</caption>
@@ -4580,7 +4575,6 @@ <h2>Definition of Roles</h2>
45804575
<td class="role-scope">
45814576
<ul>
45824577
<li><rref>directory</rref></li>
4583-
<li><rref>group</rref></li>
45844578
<li><rref>list</rref></li>
45854579
</ul>
45864580
</td>

0 commit comments

Comments
 (0)