Skip to content

Commit bcf44d1

Browse files
ariellalgilmore#1786)
Co-authored-by: Ariella Gilmore <[email protected]>
1 parent c625cb7 commit bcf44d1

File tree

2 files changed

+3
-3
lines changed

2 files changed

+3
-3
lines changed

index.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -3899,7 +3899,7 @@ <h2>Definition of Roles</h2>
38993899
<div class="role-description">
39003900
<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>
39013901
<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>
3902-
<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>
3902+
<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>
39033903
<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>
39043904
</div>
39053905
<table class="role-features">

validator-tests/listbox-group-children-must-be-option.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
<!DOCTYPE html>
22
<html lang="en-US">
3-
<head><title>In the context of a listbox, the children of a group element must be option elements.</title></head>
3+
<head><title>In the context of a listbox, for example, the children of a group element must be option elements.</title></head>
44
<body>
55
<!--
66
URL: https://www.w3.org/TR/wai-aria-1.2/#group
7-
RULE: "when a group is used in the context of a listbox, authors MUST limit
7+
RULE: "when a group is used in the context of a listbox, for example, authors MUST limit
88
* its children to option elements."
99
-->
1010

0 commit comments

Comments
 (0)

Follow Lee on X/Twitter - Father, Husband, Serial builder creating AI, crypto, games & web tools. We are friends :) AI Will Come To Life!

Check out: eBank.nz (Art Generator) | Netwrck.com (AI Tools) | Text-Generator.io (AI API) | BitBank.nz (Crypto AI) | ReadingTime (Kids Reading) | RewordGame | BigMultiplayerChess | WebFiddle | How.nz | Helix AI Assistant