[a11y]: DefinitionTooltip content not announced by JAWS #19285
Labels
a11y: JAWS
Screen reader issues, specifically JAWS
component: tooltip
package: @carbon/react
@carbon/react
role: dev 🤖
type: a11y ♿
type: bug 🐛
Comments
riddhybansal
added
a11y: JAWS
wkeese
added a commit
to wkeese/carbon
that referenced
this issue
May 27, 2025
Use aria-describedby for DefinitionTooltip just like Tooltip, to link the term to its definition. Addresses the problem that JAWS doesn't announce the definition when the tooltip is opened, at least when opened by hover (openOnHover === true) rather than clicking. Fixes carbon-design-system#19285
6 tasks
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Package
@carbon/react
Browser
Chrome
Operating System
MacOS
Package version
1.80
React version
18
Automated testing tool and ruleset
manual test
Assistive technology
JAWS
Description
Apparently, JAWS doesn’t announce the definitions for Carbon’s DefinitionTooltip.
But, I noticed that the content is missing
aria-live="polite", so maybe that's the only problem.Contrast with Toggletip which does have
aria-live="polite".My other hypothesis was that it was because JAWS doesn’t expect a mere focus change to trigger a content change. Hopefully that's not the issue as it would be hard to fix without removing the current open-on-focus behavior.
WCAG 2.1 Violation
No response
Reproduction/example
https://react.carbondesignsystem.com/?path=/story/components-definitiontooltip--default
Steps to reproduce
Just use JAWS on the DefinitionTooltip story (https://react.carbondesignsystem.com/iframe.html?globals=&args=&id=components-definitiontooltip--default&viewMode=story).
Suggested Severity
None
Code of Conduct
The text was updated successfully, but these errors were encountered: