Skip to content

fix: use correct enable-focus-wrap-without-sentinels flag name#21123

Merged
heloiselui merged 8 commits into
carbon-design-system:mainfrom
jlongshore:fix_focus_sentinel_16389
Jun 1, 2026
Merged

fix: use correct enable-focus-wrap-without-sentinels flag name#21123
heloiselui merged 8 commits into
carbon-design-system:mainfrom
jlongshore:fix_focus_sentinel_16389

Conversation

@jlongshore

@jlongshore jlongshore commented Dec 3, 2025

Copy link
Copy Markdown
Contributor

Closes #16389

This updates a few places we use enable-focus-wrap-without-sentinels and also the above issue now has a comment that the intended fix is to use the flag to avoid the issue.

Original (outdated) scope

Visually hidden link "Focus sentinel" is announced by the screen reader before notifications title and after close button.

Changelog

Changed

  • Added aria-hidden properties to visually hidden "Focus sentinel" elements.
  • Noticed a few stories (ComposedModal.featureflag.stories.js and Modal.featureflag.stories.js) referring to the enable-preview-focus-wrap-without-sentinels feature flag, which I couldn't find in the codebase, so I renamed to enable-focus-wrap-without-sentinels.

Testing / Reviewing

  • Ran storybook, visually inspected elements for aria-hidden, focus trapping appeared to work as before
  • Updated snapshots / ran (and passed) tests
  • Solution seems to follow "Passed Example 4" found on w3c
  • Needs testing with assistive application like JAWS or similar (Tried with VoiceOver built into mac, but it doesn't seem to honor aria labels very well)

PR Checklist

As the author of this PR, before marking ready for review, confirm you:

  • Reviewed every line of the diff
  • Updated documentation and storybook examples
  • Wrote passing tests that cover this change
  • Addressed any impact on accessibility (a11y)
  • Tested for cross-browser consistency
  • Validated that this code is ready for review and status checks should pass

More details can be found in the pull request guide

@jlongshore jlongshore requested a review from a team as a code owner December 3, 2025 23:01
@netlify

netlify Bot commented Dec 3, 2025

Copy link
Copy Markdown

Deploy Preview for v11-carbon-web-components ready!

Name Link
🔨 Latest commit 23890d7
🔍 Latest deploy log https://app.netlify.com/projects/v11-carbon-web-components/deploys/6930c146d53ce9000845d4e1
😎 Deploy Preview https://deploy-preview-21123--v11-carbon-web-components.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.

@netlify

netlify Bot commented Dec 3, 2025

Copy link
Copy Markdown

Deploy Preview for carbon-elements ready!

Name Link
🔨 Latest commit 23890d7
🔍 Latest deploy log https://app.netlify.com/projects/carbon-elements/deploys/6930c14676e5a80008cbccce
😎 Deploy Preview https://deploy-preview-21123--carbon-elements.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.

@codecov

codecov Bot commented Dec 3, 2025

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 95.39%. Comparing base (14a7762) to head (b9bcd52).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main   #21123   +/-   ##
=======================================
  Coverage   95.39%   95.39%           
=======================================
  Files         543      543           
  Lines       48465    48465           
  Branches     6737     6762   +25     
=======================================
  Hits        46232    46232           
  Misses       2108     2108           
  Partials      125      125           
Flag Coverage Δ
main-packages 87.82% <ø> (ø)
web-components 98.07% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@netlify

netlify Bot commented Dec 3, 2025

Copy link
Copy Markdown

Deploy Preview for v11-carbon-react ready!

Name Link
🔨 Latest commit 23890d7
🔍 Latest deploy log https://app.netlify.com/projects/v11-carbon-react/deploys/6930c1461fe5e30008e146b9
😎 Deploy Preview https://deploy-preview-21123--v11-carbon-react.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.

@netlify

netlify Bot commented Dec 3, 2025

Copy link
Copy Markdown

Deploy Preview for v11-carbon-web-components ready!

Name Link
🔨 Latest commit b9bcd52
🔍 Latest deploy log https://app.netlify.com/projects/v11-carbon-web-components/deploys/6a1e06d217ce290008fa5d4c
😎 Deploy Preview https://deploy-preview-21123--v11-carbon-web-components.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

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

@netlify

netlify Bot commented Dec 3, 2025

Copy link
Copy Markdown

Deploy Preview for carbon-elements ready!

Name Link
🔨 Latest commit b9bcd52
🔍 Latest deploy log https://app.netlify.com/projects/carbon-elements/deploys/6a1e06d2bac438000819c51c
😎 Deploy Preview https://deploy-preview-21123--carbon-elements.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

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

@netlify

netlify Bot commented Dec 3, 2025

Copy link
Copy Markdown

Deploy Preview for v11-carbon-react ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit b9bcd52
🔍 Latest deploy log https://app.netlify.com/projects/v11-carbon-react/deploys/6a1e06d24f81b200071aeea2
😎 Deploy Preview https://deploy-preview-21123--v11-carbon-react.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

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

@tay1orjones tay1orjones left a comment

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.

IIRC in the past aria-hidden wasn't put on the sentinel nodes because they're technically still focusable and shouldn't be removed from the accessibility tree. There might be some past issue/discussions on the topic.

@jlongshore

Copy link
Copy Markdown
Contributor Author

IIRC in the past aria-hidden wasn't put on the sentinel nodes because they're technically still focusable and shouldn't be removed from the accessibility tree. There might be some past issue/discussions on the topic.

Ahh... yeah I'm missing any of that past discussion... and with the ability to use feature flags to get around the sentinel issue, should we just close this @tay1orjones?

@alisonjoseph

Copy link
Copy Markdown
Contributor

@jlongshore @tay1orjones I think we still want the updated feature flag naming you have here regardless even if we revert the aria-hidden change?

@alisonjoseph alisonjoseph removed the a11y: JAWS Screen reader issues, specifically JAWS label Dec 5, 2025
@tay1orjones tay1orjones requested review from emyarod and removed request for Gururajj77 and alisonjoseph March 26, 2026 21:42
@tay1orjones tay1orjones changed the title fix: focus sentinel text being read by jaws fix: use correct enable-focus-wrap-without-sentinels flag name Mar 26, 2026
@tay1orjones

Copy link
Copy Markdown
Member

Yes, I've updated this to remove the aria-hidden additions, leave the other, and also updated the original issue stating that using the flag is the intended way to "fix" to avoid the issue.

@emyarod emyarod left a comment

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.

looks good to me!

@heloiselui heloiselui added this pull request to the merge queue Jun 1, 2026
Merged via the queue into carbon-design-system:main with commit 70ce251 Jun 1, 2026
39 of 40 checks passed
@carbon-automation

Copy link
Copy Markdown
Contributor

Hey there! v11.109.0 was just released that references this issue/PR.

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.

[a11y]: Notifications - Actionable Link focus sentinel

6 participants