Bug description
Tooltips in the CP are shown on hover but cannot be dismissed with Escape and cannot be hovered, which fails two of the three conditions in WCAG 2.1 SC 1.4.13 Content on Hover or Focus (Level AA).
Measured against the sidebar's "Toggle Nav" button on /cp/dashboard:
| 1.4.13 condition |
Result |
| Dismissible — can be removed without moving pointer or focus |
FAIL — Escape does nothing |
| Hoverable — pointer can move onto the tooltip without it disappearing |
FAIL — it vanishes |
| Persistent — stays until dismissed, focus moves, or it stops being valid |
PASS — still visible after 4s |
{ "tooltipShown": true, "role": null, "text": "Toggle Nav",
"cls": "v-popper__popper v-popper--theme-tooltip v-popper__popper--shown",
"dismissibleByEscape": false, "hoverable": false, "persistentAfter4s": true }
The tooltip also carries no role="tooltip", so it isn't announced as one.
Tooltips come from floating-vue (v-tooltip), registered in https://github.com/statamic/cms/blob/v6.31.0/resources/js/bootstrap/statamic.js#L10. Both failing conditions are configurable there rather than requiring per-call-site changes.
This matters more than usual in Statamic's CP because tooltips are sometimes the only text alternative for an icon-only control — see the status indicator issue I'm filing alongside this, where v-tooltip is the sole carrier of "Published" / "Draft" / "Scheduled" / "Expired".
How to reproduce
composer create-project statamic/statamic, log in
- Hover the sidebar collapse button in the global header until the tooltip shows
- Press Escape — the tooltip stays
- Hover the tooltip itself — it disappears
Suggested fix
floating-vue supports both:
- register a global
hideOnTargetClick/Escape handler, or set instantMove plus an onKeydown that hides on Escape
- set the tooltip theme's
disposeTimeout / pointer-events so the popper is hoverable rather than pointer-events-none
Adding role="tooltip" on the popper would also let assistive technology announce it correctly.
Environment
Environment
Laravel Version: 13.30.1
PHP Version: 8.4.23
Composer Version: 2.10.2
Environment: local
Debug Mode: ENABLED
Maintenance Mode: OFF
Timezone: UTC
Locale: en
Cache
Config: NOT CACHED
Events: NOT CACHED
Routes: NOT CACHED
Views: CACHED
Drivers
Broadcasting: log
Cache: file
Database: sqlite
Logs: stack / single
Mail: log
Queue: sync
Session: file
Storage
public/storage: NOT LINKED
Statamic
Addons: 0
License Key: Not set
Sites: 1
Stache Watcher: Enabled (auto)
Static Caching: Disabled
Version: 6.31.0 PRO
Installation
Fresh statamic/statamic site via CLI
Additional details
Found during a WCAG 2.1 AA audit of a vanilla composer create-project statamic/statamic install with no addons and no custom code. Tested with axe-core 4.x on Chromium 153 at 1440x1000, plus manual keyboard traversal. Source references point at v6.31.0.
Bug description
Tooltips in the CP are shown on hover but cannot be dismissed with Escape and cannot be hovered, which fails two of the three conditions in WCAG 2.1 SC 1.4.13 Content on Hover or Focus (Level AA).
Measured against the sidebar's "Toggle Nav" button on
/cp/dashboard:{ "tooltipShown": true, "role": null, "text": "Toggle Nav", "cls": "v-popper__popper v-popper--theme-tooltip v-popper__popper--shown", "dismissibleByEscape": false, "hoverable": false, "persistentAfter4s": true }The tooltip also carries no
role="tooltip", so it isn't announced as one.Tooltips come from
floating-vue(v-tooltip), registered in https://github.com/statamic/cms/blob/v6.31.0/resources/js/bootstrap/statamic.js#L10. Both failing conditions are configurable there rather than requiring per-call-site changes.This matters more than usual in Statamic's CP because tooltips are sometimes the only text alternative for an icon-only control — see the status indicator issue I'm filing alongside this, where
v-tooltipis the sole carrier of "Published" / "Draft" / "Scheduled" / "Expired".How to reproduce
composer create-project statamic/statamic, log inSuggested fix
floating-vue supports both:
hideOnTargetClick/Escape handler, or setinstantMoveplus anonKeydownthat hides on EscapedisposeTimeout/ pointer-events so the popper is hoverable rather than pointer-events-noneAdding
role="tooltip"on the popper would also let assistive technology announce it correctly.Environment
Installation
Fresh statamic/statamic site via CLI
Additional details
Found during a WCAG 2.1 AA audit of a vanilla
composer create-project statamic/statamicinstall with no addons and no custom code. Tested with axe-core 4.x on Chromium 153 at 1440x1000, plus manual keyboard traversal. Source references point atv6.31.0.