Skip to main content
← All Demos

Tooltip

Tooltip displays short helper text for an element on hover or focus.

1. Basic Tooltip

Hover or focus the trigger to show tooltip. Screen readers announce tooltip content via aria-describedby.

Keyboard: Tab to focus trigger → Tooltip appears → Escape to dismiss → Tab away hides tooltip
<Tooltip.Provider>
  <Tooltip.Root>
    <Tooltip.Trigger>Hover me</Tooltip.Trigger>
    <Tooltip.Content>This is helpful tooltip text</Tooltip.Content>
  </Tooltip.Root>
</Tooltip.Provider>

2. Custom Delay

Tooltip with a shorter delay (200ms) and a longer delay (1500ms). Provider-level delayDuration sets the default for all tooltips.

<Tooltip.Provider delayDuration={200}>
  <Tooltip.Root>
    <Tooltip.Trigger>Fast</Tooltip.Trigger>
    <Tooltip.Content>I appear quickly</Tooltip.Content>
  </Tooltip.Root>
</Tooltip.Provider>

3. Skip Delay Between Tooltips

When moving between tooltips quickly, the delay is skipped. skipDelayDuration controls the window for instant show.

Test: Hover A, then quickly move to B and C — they should appear instantly.
<Tooltip.Provider delayDuration={700} skipDelayDuration={300}>
  <Tooltip.Root>
    <Tooltip.Trigger>Button A</Tooltip.Trigger>
    <Tooltip.Content>Tooltip A</Tooltip.Content>
  </Tooltip.Root>
</Tooltip.Provider>

4. Controlled Tooltip

Parent manages tooltip visibility. Can be shown/hidden programmatically.

const [open, setOpen] = useState(false);

<Tooltip.Root open={open} onOpenChange={(nextOpen) => setOpen(nextOpen)}>
  <Tooltip.Trigger>Controlled trigger</Tooltip.Trigger>
  <Tooltip.Content>Controlled tooltip</Tooltip.Content>
</Tooltip.Root>

5. Default Open

Tooltip that starts visible on mount.

<Tooltip.Root defaultOpen>
  <Tooltip.Trigger>Visible trigger</Tooltip.Trigger>
  <Tooltip.Content>I was open from the start!</Tooltip.Content>
</Tooltip.Root>

6. Disabled Tooltip

Tooltip with a disabled trigger. Tooltip should still work on hover but the trigger cannot be activated.

<Tooltip.Root>
  <Tooltip.Trigger disabled>Disabled button</Tooltip.Trigger>
  <Tooltip.Content>This button is disabled</Tooltip.Content>
</Tooltip.Root>

7. Long Tooltip Content

Tooltips with longer descriptions. Should wrap properly within max-width.

<Tooltip.Root>
  <Tooltip.Trigger>Long</Tooltip.Trigger>
  <Tooltip.Content>This is a much longer tooltip text.</Tooltip.Content>
</Tooltip.Root>

8. Render Props Pattern

Trigger exposes isOpen for custom rendering.

<Tooltip.Root>
  <Tooltip.Trigger>
    {({ isOpen }) => (isOpen ? 'Tooltip visible' : 'Hover for info')}
  </Tooltip.Trigger>
  <Tooltip.Content>Trigger text changes when shown</Tooltip.Content>
</Tooltip.Root>
← All Demos