# Tooltip

> A short label for an icon-only control. After the first, neighbours open instantly.

Category: Overlays · Atomic level: atom · Built on Base UI Tooltip
Page: https://ui.dtheo.dev/docs/components/tooltip

## Install

```bash
npx dtheo@latest add tooltip
# or, with the shadcn CLI
npx shadcn@latest add https://ui.dtheo.dev/r/tooltip.json
```

Dependencies: @base-ui/react, clsx, tailwind-merge. Registry dependencies: utils.

## Exports

`TooltipProvider`, `Tooltip`, `TooltipTrigger`, `TooltipContent`

## Use it for

- Naming icon buttons
- Revealing a truncated value

## Reach for something else

- Essential information or actions: touch users never see tooltips

## Examples

### tooltip

```tsx
import { DownloadIcon, LinkIcon, MaximizeIcon, ZoomInIcon, ZoomOutIcon } from 'lucide-react';
import { Button } from '@/components/ui/button';
import { Separator } from '@/components/ui/separator';
import { Tooltip, TooltipContent, TooltipTrigger } from '@/components/ui/tooltip';

const tools = [
  [
    { label: 'Zoom in', icon: ZoomInIcon },
    { label: 'Zoom out', icon: ZoomOutIcon },
    { label: 'Fit to run', icon: MaximizeIcon },
  ],
  [
    { label: 'Download PNG', icon: DownloadIcon },
    { label: 'Copy link to this view', icon: LinkIcon },
  ],
];

const tracePath = 'traces/bench-3/R-0412_high-gain-step_torque.csv';

export default function TooltipExample() {
  return (
    <div className="flex w-full max-w-md items-center gap-1 rounded-card border border-border bg-card p-1 pl-3">
      {/* A truncated value: the tooltip reveals the whole path on hover. */}
      <Tooltip>
        <TooltipTrigger
          render={<span className="min-w-0 flex-1 truncate text-label text-muted-foreground" />}
        >
          {tracePath}
        </TooltipTrigger>
        <TooltipContent className="max-w-none">{tracePath}</TooltipContent>
      </Tooltip>
      {/* Icon-only buttons: after the first tooltip opens, its neighbours open instantly. */}
      {tools.map((group, i) => (
        <div key={group[0]?.label} className="flex shrink-0 items-center gap-0.5">
          {i > 0 ? <Separator orientation="vertical" className="mx-1 h-4" /> : null}
          {group.map(({ label, icon: Icon }) => (
            <Tooltip key={label}>
              <TooltipTrigger render={<Button variant="ghost" size="icon-sm" aria-label={label} />}>
                <Icon aria-hidden="true" />
              </TooltipTrigger>
              <TooltipContent>{label}</TooltipContent>
            </Tooltip>
          ))}
        </div>
      ))}
    </div>
  );
}
```

## Used in

- Run review (page): https://ui.dtheo.dev/examples/run-review
