Tooltips are neither dismissible nor hoverable (WCAG 1.4.13)
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 74/100
- issue の種類
- バグ
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- javascript
調査の方向性
まず resources/js/bootstrap/statamic.js を開き、floating-vue の tooltip/dropdown ディレクティブが登録されている箇所（10行目付近）を確認し、その後、Escape 解除、hoverable な popper（pointer-events/dispose 遅延）、role="tooltip" アトリビュートに関するグローバルオプションについて floating-vue のドキュメントを参照する。この issue には正確な再現手順が含まれている：/cp/dashboard のサイドバーの Toggle Nav ボタンにホバーし、Escape キーを押す。完了の条件は、そのツールチップで WCAG 1.4.13 の 3 つの条件すべてが満たされ、popper が role="tooltip" を持つことで、issue に記載された JSON チェックにより再測定すること。
索引モデルが issue の本文から書いたものです。
説明
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 setinstantMoveplus anonKeydownthat 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.
- 主要言語
- PHP
- スター
- 4.9k
- フォーク
- 647
- 平均マージ
- 1日 9時間
- マージ済み PR（30日）
- 102
環境構築
このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
statamic/cms のほかの issue
-
難易度 1/5 1時間未満 初心者へのやさしさ 82/100
メンテナーはふだん 1 日以内に返信
-
assets
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 74/100
メンテナーはふだん 1 日以内に返信
-
antlers
難易度 2/5 1〜3時間 初心者へのやさしさ 66/100
メンテナーはふだん 1 日以内に返信
-
CP Cache Utility: Opening the cache manager times out when the Glide Cached Presets are too bigオープンutilities
難易度 4/5 3〜5日 初心者へのやさしさ 35/100
statamic/cms#15623 · リアクション 2 件 ·
メンテナーはふだん 1 日以内に返信
似ている issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
メンテナーはふだん 2 日以内に返信
-
backend bug
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
-
bug
難易度 1/5 1時間未満 初心者へのやさしさ 85/100
-
難易度 2/5 1〜3時間 初心者へのやさしさ 63/100
smarty-php/smarty#1215 ·