Tooltip displays short helper text for an element on hover or focus.
Hover or focus the trigger to show tooltip. Screen readers announce tooltip content via aria-describedby.
<Tooltip.Provider>
<Tooltip.Root>
<Tooltip.Trigger>Hover me</Tooltip.Trigger>
<Tooltip.Content>This is helpful tooltip text</Tooltip.Content>
</Tooltip.Root>
</Tooltip.Provider>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>When moving between tooltips quickly, the delay is skipped. skipDelayDuration controls the window for instant show.
<Tooltip.Provider delayDuration={700} skipDelayDuration={300}>
<Tooltip.Root>
<Tooltip.Trigger>Button A</Tooltip.Trigger>
<Tooltip.Content>Tooltip A</Tooltip.Content>
</Tooltip.Root>
</Tooltip.Provider>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>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>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>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>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>