Tooltip

A label that provides information on hover or focus.

Anatomy

To set up the tooltip correctly, you’ll need to understand its anatomy and how we name its parts.

Each part includes a data-part attribute to help identify them in the DOM.

Examples

Learn how to use the Tooltip component in your project. Let’s take a look at the most basic example:

Controlled Tooltip

To create a controlled Tooltip component, manage the state of whether the tooltip is open using the open prop:

Using a Render Function

For more control over the Tooltip’s functionality, you can use a function as a child, which provides access to the Tooltip API:

Adding an Arrow

To display an arrow pointing to the trigger from the tooltip, use the Tooltip.Arrow and Tooltip.ArrowTip components:

Configuring Delay Timings

To configure the delay timings for the Tooltip, use the closeDelay and openDelay props:

Custom Positioning

To customize the position of the Tooltip relative to the trigger, use the positioning prop:

API Reference

Root

PropTypeDefault
aria-label
string
closeDelay
number
closeOnEsc
boolean
closeOnPointerDown
boolean
defaultOpen
boolean
disabled
boolean
id
string
ids
Partial<{ trigger: string content: string arrow: string positioner: string }>
interactive
boolean
lazyMount
booleanfalse
onExitComplete
() => void
onOpenChange
(details: OpenChangeDetails) => void
open
boolean
openDelay
number
positioning
PositioningOptions
present
boolean
unmountOnExit
booleanfalse

Arrow

PropTypeDefault
asChild
boolean

ArrowTip

PropTypeDefault
asChild
boolean

Content

PropTypeDefault
asChild
boolean

Positioner

PropTypeDefault
asChild
boolean

Trigger

PropTypeDefault
asChild
boolean