Skip to content

Commit fb322c9

Browse files
authored
Corrects conflicting language on focus management in several roles. (#2773)
Changes instances where role definitions had SHOULD while Section 4.3.1 specified MUST. Also clarifies Section 4.3.1 regarding focus management expectations.
1 parent 5a1b83f commit fb322c9

1 file changed

Lines changed: 8 additions & 8 deletions

File tree

index.html

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -960,7 +960,7 @@ <h3>Information for Authors</h3>
960960
Authors SHOULD ensure that all interactive [=elements=] are <a>focusable</a> and that all parts of composite widgets are either focusable or have a documented alternative method to achieve
961961
their function.
962962
</p>
963-
<p>Authors MUST manage focus on the following container roles:</p>
963+
<p>Authors MUST manage focus for the expected interactive elements of the following container roles:</p>
964964
<ul>
965965
<li><rref>grid</rref></li>
966966
<li><rref>listbox</rref></li>
@@ -4456,7 +4456,7 @@ <h2>Definition of Roles</h2>
44564456
<rref>rowgroup</rref>, or <code>grid</code>.
44574457
</p>
44584458
<p>
4459-
To be <a>keyboard accessible</a>, authors SHOULD manage focus of descendants of a <code>grid</code> as described in <a href="#managingfocus">Managing Focus</a>. When a user is navigating
4459+
To be <a>keyboard accessible</a>, authors MUST manage focus of descendants of a <code>grid</code> as described in <a href="#managingfocus">Managing Focus</a>. When a user is navigating
44604460
the <code>grid</code> content with a keyboard, authors SHOULD set focus as follows:
44614461
</p>
44624462
<ul>
@@ -5458,7 +5458,7 @@ <h2>Definition of Roles</h2>
54585458
elements whose <a>role</a> is <rref>group</rref> which in turn contain children whose <a>role</a> is <rref>option</rref>.
54595459
</p>
54605460
<p>
5461-
To be <a>keyboard accessible</a>, authors SHOULD manage focus of <rref>option</rref> descendants for all instances of this <a>role</a>, as described in
5461+
To be <a>keyboard accessible</a>, authors MUST manage focus of <rref>option</rref> descendants for all instances of this <a>role</a>, as described in
54625462
<a href="#managingfocus">Managing Focus</a>.
54635463
</p>
54645464
<p>Elements with the role <code>listbox</code> have an implicit <pref>aria-orientation</pref> value of <code>vertical</code>.</p>
@@ -6173,7 +6173,7 @@ <h4>Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula</h4>
61736173
The <code>menu</code> <a>role</a> is appropriate when a set of menu items is presented in a manner similar to a popup menu. For instance, a menu could be used to represent a context menu
61746174
for its invoking element, or it would be used to render sub-menus for items of a <rref>menubar</rref> or another <code>menu</code> popup.
61756175
</p>
6176-
<p>To be <a>keyboard accessible</a>, authors SHOULD manage focus of descendants for all instances of this <a>role</a>, as described in <a href="#managingfocus">Managing Focus</a>.</p>
6176+
<p>To be <a>keyboard accessible</a>, authors MUST manage focus of descendants for all instances of this <a>role</a>, as described in <a href="#managingfocus">Managing Focus</a>.</p>
61776177
<p>Elements with the role <code>menu</code> have an implicit <pref>aria-orientation</pref> value of <code>vertical</code>.</p>
61786178
</div>
61796179
<table class="def">
@@ -6277,7 +6277,7 @@ <h4>Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula</h4>
62776277
The <code>menubar</code> <a>role</a> is used to create a menu bar similar to those found in Windows, Mac, and Gnome desktop applications. A menu bar is used to create a consistent set of
62786278
frequently used commands. Authors SHOULD ensure that <code>menubar</code> interaction is similar to the typical menu bar interaction in a desktop graphical user interface.
62796279
</p>
6280-
<p>To be <a>keyboard accessible</a>, authors SHOULD manage focus of descendants for all instances of this <a>role</a>, as described in <a href="#managingfocus">Managing Focus</a>.</p>
6280+
<p>To be <a>keyboard accessible</a>, authors MUST manage focus of descendants for all instances of this <a>role</a>, as described in <a href="#managingfocus">Managing Focus</a>.</p>
62816281
<p>Elements with the role <code>menubar</code> have an implicit <pref>aria-orientation</pref> value of <code>horizontal</code>.</p>
62826282
</div>
62836283
<table class="def">
@@ -10447,7 +10447,7 @@ <h5>Presentational Role Inheritance</h5>
1044710447
<rdef>tablist</rdef>
1044810448
<div class="role-description">
1044910449
<p>A list of <rref>tab</rref> [=elements=], which are references to <rref>tabpanel</rref> elements.</p>
10450-
<p>To be <a>keyboard accessible</a>, authors SHOULD manage focus of descendants for all instances of this <a>role</a>, as described in <a href="#managingfocus">Managing Focus</a>.</p>
10450+
<p>To be <a>keyboard accessible</a>, authors MUST manage focus of descendants for all instances of this <a>role</a>, as described in <a href="#managingfocus">Managing Focus</a>.</p>
1045110451

1045210452
<!-- keep following para synced with its counterpart in #tab -->
1045310453
<p>
@@ -11366,7 +11366,7 @@ <h5>Presentational Role Inheritance</h5>
1136611366
<rdef>tree</rdef>
1136711367
<div class="role-description">
1136811368
<p>A <rref>widget</rref> that allows the user to select one or more items from a hierarchically organized collection.</p>
11369-
<p>To be <a>keyboard accessible</a>, authors SHOULD manage focus of descendants for all instances of this <a>role</a>, as described in <a href="#managingfocus">Managing Focus</a>.</p>
11369+
<p>To be <a>keyboard accessible</a>, authors MUST manage focus of descendants for all instances of this <a>role</a>, as described in <a href="#managingfocus">Managing Focus</a>.</p>
1137011370
<p>Elements with the role <code>tree</code> have an implicit <pref>aria-orientation</pref> value of <code>vertical</code>.</p>
1137111371
</div>
1137211372
<table class="def">
@@ -11473,7 +11473,7 @@ <h5>Presentational Role Inheritance</h5>
1147311473
<pref>aria-readonly</pref> to <code>true</code> on the <rref>gridcell</rref> element. However, if a <code>treegrid</code> presents a collection of elements that do not support
1147411474
<pref>aria-readonly</pref>, such as a collection of <rref>link</rref> elements, it is not necessary for the author to specify a value for <pref>aria-readonly</pref>.
1147511475
</p>
11476-
<p>To be <a>keyboard accessible</a>, authors SHOULD manage focus of descendants for all instances of this <a>role</a>, as described in <a href="#managingfocus">Managing Focus</a>.</p>
11476+
<p>To be <a>keyboard accessible</a>, authors MUST manage focus of descendants for all instances of this <a>role</a>, as described in <a href="#managingfocus">Managing Focus</a>.</p>
1147711477
</div>
1147811478
<table class="def">
1147911479
<caption>

0 commit comments

Comments
 (0)