Skip to main content

Common Examples

Use TooltipSurface when another interaction already knows what to explain and where to place it, such as a chart overlay. It provides no trigger, open state, timing, or positioning. Touch has no hover, so a host that owns open and dismiss wraps this surface rather than reimplementing the pill.
content accepts a string or composed nodes. A plain string or number is wrapped in the tooltip’s typography. caret places a caret on the matching edge and points its tip away from the pill. The surface draws that direction only; the host decides where the pill sits.

Accessibility

  • The pill is read as a single element so composed rows do not announce as fragments.
  • Set accessibilityLabel when composed content does not form a sentence.
  • Nested interactive controls inside content are swallowed on iOS because the root is accessible.
Last modified on September 1, 2026