Components · Feedback & Status

Tooltip

A short hint shown on hover or keyboard focus.

Automated a11y scan passing Element: <div role="tooltip">

Component Workbench

Switch between the live interactive preview, syntax-highlighted implementation code, copyable AI coding agent prompt, and designer anatomy blueprint.

Tooltip · Canonical Spec

When to use it

Do

  • Use it to name icon buttons.
  • Keep it to a few words.

Don't

  • Put links or buttons inside it. Use Popover instead.
  • Hide information people need to complete a task.

Accessibility & Keyboard Interaction

Requirements for using this component accessibly, following the W3C ARIA Authoring Practices Guide.

Interaction / KeyBehavior & Compliance Requirement
WCAG 2.2 SC 1.4.13Dismissible via Escape, hoverable, and persistent while focused.

Tokens

Values update with the current theme.

RoleTokenCurrent value
Background--as-semantic-color-text-default
Corner Radius--as-radius-sm
Esc
↑↓ navigateEnter openEsc close