Allude to other widgets that allow group in group role definition (#1786

) Co-authored-by: Ariella Gilmore <ariellalgilmore@ibm.com>
w3c · Sep 2, 2022 · bcf44d1 · bcf44d1
1 parent c625cb7
commit bcf44d1
Show file tree

Hide file tree

Showing 2 changed files with 3 additions and 3 deletions.
diff --git a/index.html b/index.html
@@ -3899,7 +3899,7 @@ <h2>Definition of Roles</h2>
 			<div class="role-description">
 				<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>
 				<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>
-				<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>
+				<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>, for example, 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>
 				<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>
 			</div>
 			<table class="role-features">

diff --git a/validator-tests/listbox-group-children-must-be-option.html b/validator-tests/listbox-group-children-must-be-option.html
@@ -1,10 +1,10 @@
 <!DOCTYPE html>
 <html lang="en-US">
-<head><title>In the context of a listbox, the children of a group element must be option elements.</title></head>
+<head><title>In the context of a listbox, for example, the children of a group element must be option elements.</title></head>
 <body>
   <!--
   URL: https://www.w3.org/TR/wai-aria-1.2/#group
-  RULE: "when a group is used in the context of a listbox, authors MUST limit
+  RULE: "when a group is used in the context of a listbox, for example, authors MUST limit
   * its children to option elements."
   -->