Skip to content
Merged
Changes from 3 commits
Commits
Show all changes
34 commits
Select commit Hold shift + click to select a range
417b9ff
Add notes to 2.4.3 understanding
patrickhlauke Feb 15, 2021
3d08ead
Tweak note about redundant focus stops
patrickhlauke Feb 15, 2021
d0138bd
Expand note to mention "card" component, give code example for nested…
patrickhlauke Feb 15, 2021
7cd188a
Remove the "redundant" part
patrickhlauke May 11, 2022
8be23bd
Remove "normatively"
patrickhlauke May 11, 2022
29dcb88
Tweak language based on suggestions from @alastc @mbgower @bruce-usab
patrickhlauke May 14, 2022
c3e0403
Fix spacing/indentation
patrickhlauke May 14, 2022
147b6fe
Tweak/expand the "western left-to-right" part
patrickhlauke May 19, 2022
0028075
Update focus-order.html
mbgower Aug 2, 2022
8667b31
Update focus-order.html
mbgower Aug 2, 2022
d0382d3
Update understanding/20/focus-order.html
patrickhlauke Jun 19, 2023
9f7feb7
Remove unnecessary "unnecessarily"
patrickhlauke Jun 27, 2023
083dbab
Update understanding/20/focus-order.html
alastc Jun 27, 2023
d841c2a
Tweaks/rewordings
patrickhlauke Jul 5, 2023
61fda92
Capitalisation
patrickhlauke Jul 6, 2023
116e230
"too many" > "unwarranted"
patrickhlauke Jul 7, 2023
aa6dcd8
Merge branch 'main' into patrickhlauke-understanding-focus-order-note
patrickhlauke Oct 31, 2023
3e33e78
Merge branch 'main' into patrickhlauke-understanding-focus-order-note
patrickhlauke Feb 15, 2024
14dc43e
Merge branch 'main' into patrickhlauke-understanding-focus-order-note
patrickhlauke Aug 29, 2024
df6eed7
Merge branch 'main' into patrickhlauke-understanding-focus-order-note
patrickhlauke Jan 22, 2025
42da714
Update understanding/20/focus-order.html
patrickhlauke Jan 22, 2025
ad8f4fb
Update understanding/20/focus-order.html
patrickhlauke Jan 22, 2025
dc8904c
Merge branch 'main' into patrickhlauke-understanding-focus-order-note
patrickhlauke Mar 28, 2025
18d56fe
Update understanding/20/focus-order.html
patrickhlauke Jul 29, 2025
509dad6
Merge branch 'main' into patrickhlauke-understanding-focus-order-note
patrickhlauke Aug 5, 2025
b3cecfb
Merge branch 'main' into patrickhlauke-understanding-focus-order-note
patrickhlauke Sep 5, 2025
7fd76fa
Merge branch 'main' into patrickhlauke-understanding-focus-order-note
patrickhlauke Sep 26, 2025
526ced4
Merge branch 'main' into patrickhlauke-understanding-focus-order-note
patrickhlauke Oct 17, 2025
d077606
Update understanding/20/focus-order.html
mbgower Oct 17, 2025
8170927
Update understanding/20/focus-order.html
mbgower Oct 17, 2025
f2c00e2
Merge branch 'main' into patrickhlauke-understanding-focus-order-note
mbgower Oct 17, 2025
1defc51
Merge branch 'main' into patrickhlauke-understanding-focus-order-note
mbgower Oct 31, 2025
dcbbb0c
Add missing language-html class to new code block
kfranqueiro Oct 31, 2025
cdd58fe
Merge branch 'main' into patrickhlauke-understanding-focus-order-note
mbgower Oct 31, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 32 additions & 0 deletions understanding/20/focus-order.html
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,32 @@ <h2>Intent of Focus Order</h2>
Web page. Care should be taken so that the focus order makes sense to both of these
sets of users and does not appear to either of them to jump around randomly.
</p>

<p>Focus order also does not normatively need to follow the visual presentation of the web page,
as long as the order in which elements receive focus is logical, and the hierarchy and relationship
of content implied by the visual presentation is preserved. For instance, in a two-column
layout, visually the assumption in western left-to-right systems may be that elements in the
Comment thread
patrickhlauke marked this conversation as resolved.
Outdated
left-hand column would receive focus first. However, if meaning and operation are not affected,
it is not a normative failure if elements in the right-hand column receive focus first.
Again, as a best practice, care should be taken to make sure the focus order does not
Comment thread
patrickhlauke marked this conversation as resolved.
Outdated
appear random and illogical.
</p>

<div class="note">
<p>Normatively, it is not a failure of this success criterion if static/non-interactive content
Comment thread
patrickhlauke marked this conversation as resolved.
Outdated
receives focus. Making an element that does not act as an actionable user interface component
focusable, or programmatically moving focus to such an element, does not necessarily constitute
a failure of this success criterion. Similarly, redundant focusable elements – for instance,
having two or more "focus stops" for what may visually appear to be a single user interface
component such as a "card" component – do not automatically fail this criterion.</p>
<p>These situations are only failures if they
significantly impede the operation of the content, or create illogical focus orders - for example, a control
Comment thread
patrickhlauke marked this conversation as resolved.
Outdated
appearing to receive focus multiple times due to the use of nested focusable elements.</p>
<pre><code>&lt;div tabindex="0"&gt;&lt;button&gt;...&lt;/button&gt;&lt;/div&gt;</code></pre>
<p>As a best practice, authors should avoid excessive use of focusable elements which cannot be operated
Comment thread
patrickhlauke marked this conversation as resolved.
Outdated
or actioned, as well as redundant focus stops, as these are likely to make operation unnecessarily
tedious for keyboard users.</p>
</div>

<p>For clarity:</p>

Expand All @@ -62,6 +88,8 @@ <h2>Intent of Focus Order</h2>
<li>Focusable components need to receive focus in an order that preserves meaning and
operability only when navigation sequences affect meaning and operability.
</li>

<li>Focus order does not need to follow visual presentation or layout.</li>
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think that I agree with this statement. The issue is that the interpretation of the visual presentation is subjective.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

does not necessarily need to follow visual presentation, perhaps? i've seen extreme cases where auditors gleefully fail things if they're not exactly in the same order as the visual, with things like three little icon-based buttons that receive focus right-to-left instead of left-to-right (because the author used CSS floats that effectively reversed the order) ... but where the meaning was not impacted and it was not really a problem.

there must be some way we can somehow make that clear...

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, add "necessarily".

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

wonder if it's too handwavy though. maybe best to expand this, or add some more words that reflect what @awkawk rightly says...that it's subjective?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Who is deciding what is the visual presentation order? Shouldn't the tab order follow whatever that is decided to be?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

or adding "as long as meaning/operation are not affected"

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Who is deciding what is the visual presentation order?" not sure i follow...is this rhetorical? the author/designer will work on the visual/layout, but for various reasons the focus order may be slightly different. the point is that as long as meaning/operation aren't affected (and it's...subjectively...not too haphazard jumping all over the place) it's not necessarily a failure if the focus order doesn't strictly follow the western top-to-bottom/left-to-right (in left-to-right writing cultures)

Comment thread
alastc marked this conversation as resolved.
Outdated

<li>In those cases where it is required, there may be more than one order that will preserve
meaning and operability.
Expand All @@ -70,6 +98,10 @@ <h2>Intent of Focus Order</h2>
<li>If there is more than one order that preserves meaning and operability, only one of
them needs to be provided.
</li>

<li>Redundant focus stops, and static/non-interactive elements receiving focus, are allowed, as
long as they don't significantly impede operation of the content.
</li>

</ol>

Expand Down