Skip to content

Suggested additional note for focus-not-obscured (AAA), tweak AA note #4403

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 4 commits into
base: main
Choose a base branch
from

Conversation

patrickhlauke
Copy link
Member

@patrickhlauke patrickhlauke commented May 18, 2025

AAA version of the note that was added for AA in #4104

Includes a small tweak to the AA note as well regarding focus indicator not being fully obscured

AAA version of the note that was added for AA in #4104
Copy link

netlify bot commented May 18, 2025

Deploy Preview for wcag2 ready!

Name Link
🔨 Latest commit a4fecfd
🔍 Latest deploy log https://app.netlify.com/projects/wcag2/deploys/68473b35d3eb5f000857ef50
😎 Deploy Preview https://deploy-preview-4403--wcag2.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@patrickhlauke
Copy link
Member Author

@dbjorge you mentioned in our call that the quote bit needs to be updated "no part of the component is hidden" ... but that is the wording used in the AAA version https://www.w3.org/TR/WCAG22/#focus-not-obscured-enhanced ... so i think we're good with this?

@@ -23,6 +23,7 @@

Intent of Focus Not Obscured (Enhanced)

Typical types of content that can overlap focused items are sticky footers, sticky headers, and non-modal dialogs. As a user tabs through the page, these layers of content can hide the item receiving focus, along with its focus indicator.

A notification implemented as sticky content, such as a cookie banner, will fail this success criterion if it partially covers a component receiving focus. Ways of passing include making the banner modal so the user has to dismiss the banner before navigating through the page, or using scroll padding so the banner does not overlap other content. Notifications that do not require user action could also meet this criterion by closing on loss of focus.

Another form of obscuring can occur where light boxes or other semi-opaque effects overlap the item with focus. This form of obscuring is not in scope for this success criterion. While less than 100 percent opacity is not causing the component to be visually hidden, such semi-opaque overlaps may cause a failure of 1.4.11 Non-text Contrast and/or 2.4.13 Focus Appearance. When a focus indicator can be covered by a semi-opaque component, the focus indicator should be assessed against 1.4.11 and 2.4.13. The intention in both situations is that the component receiving focus should never be obscured to the point a user cannot tell which item has focus.

This criterion evaluates the focused component, rather than the focus indicator. The component itself does not include the focus indicator when checking that "no part of the component is hidden" - unless the focus indicator is inside the component, or focus is indicated by a change to the component itself. Although users benefit from both the component and the focus indicator (if external to the component) not being obscured when tracking the focus, for the purposes of this criterion only checking the component provides a clearer metric. However, if the focus indicator is obscured, it would likely fail 2.4.7 Focus Visible.

Copy link
Contributor

@mbgower mbgower Jun 6, 2025

Choose a reason for hiding this comment

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

Slight wording changes to improve readability and to match the wording to the context of the AAA requirement.

Suggested change
<p class="note">This criterion evaluates the focused <em>componentem>, rather than the focus <em>indicatorem>. The component itself does not include the focus indicator when checking that "no part of the component is hidden" - unless the focus indicator is inside the component, or focus is indicated by a change to the component itself. Although users benefit from both the component and the focus indicator (if external to the component) not being obscured when tracking the focus, for the purposes of this criterion only checking the component provides a clearer metric. However, if the focus indicator is obscured, it would likely fail <a href="focus-visible">2.4.7 Focus Visiblea>.p>
<p class="note">This criterion evaluates the focused <em>componentem>, rather than the focus <em>indicatorem>. The component itself does not include the focus indicator when checking that "no part of the component is hidden" unless the focus indicator is inside the component, or focus is indicated by a change to the component itself. Users benefit from both the component and the focus indicator (if external to the component) not being obscured when tracking the focus; however, for the purposes of this criterion, only checking the component provides a clearer metric. If the focus indicator is fully obscured, it would likely fail <a href="focus-visible">2.4.7 Focus Visiblea>.p>

Copy link
Member Author

@patrickhlauke patrickhlauke Jun 6, 2025

Choose a reason for hiding this comment

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

I don't think it makes sense to change that here. It matches the wording we already agreed on and used in the AA note #4104 and doesn't need changing for the AAA

Copy link
Contributor

Choose a reason for hiding this comment

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

If you don't think it's more readable with the changes, okay. But if you think the mild editorial tweaks improve readability, maybe we should upgrade the AA at the same time. I think we should definitely consider the final change for "fully", as this is only likely to cause a failure of 2.4.7 if the focus indicator is fully obscured, no?

Copy link
Member Author

@patrickhlauke patrickhlauke Jun 9, 2025

Choose a reason for hiding this comment

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

the AA note didn't include "fully" https://github.com/w3c/wcag/pull/4104/files so yes that would need to be patched there too to keep them in line.

Copy link
Member Author

Choose a reason for hiding this comment

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

done the "fully" to both AA and AAA, tweaked the PR description accordingly

@patrickhlauke patrickhlauke changed the title Suggested additional note for focus-not-obscured (AAA) Suggested additional note for focus-not-obscured (AAA), tweak AA note Jun 9, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants