Skip to content

[Accessibility]: Global `Tooltip` requirements

Created by: umpox

Problem description

Tooltips need to be reconsidered as part of WCAG 2.1.

See https://sarahmhigley.com/writing/tooltips-in-wcag-21/#:~:text=WCAG%202.1%20requires%20any%20content,will%20never%20overlap%20other%20content). for more information.

Expected behavior

Acceptance criteria:

Our Tooltips should:

  • Hide when a keyboard user presses "Escape" (unless the tooltip will never overlap other content).
  • Allow a mouse or pointer user to hide the tooltip, ideally through a close button (unless the tooltip will never overlap other content). The tooltip should not re-appear on subsequent hovers -- think of a zoom user trying to center their view on a specific area without triggering the tooltip and obscuring content.
  • Allow a mouse user to move their mouse over the tooltip content without dismissing the tooltip -- ideally in a manner that does not require laser focus and precision mouse control.
  • Remain in view until the user actively dismisses it, or it is no longer valid (e.g. if a loading tooltip appeared, then it could disappear after the content loaded).

Additional details

No response