Files
shadcn-ui/apps/v4/content/docs/components/base/tooltip.mdx
2026-01-21 12:30:45 +04:00

95 lines
1.8 KiB
Plaintext

---
title: Tooltip
description: A popup that displays information related to an element when the element receives keyboard focus or the mouse hovers over it.
base: base
component: true
links:
doc: https://base-ui.com/react/components/tooltip
api: https://base-ui.com/react/components/tooltip#api-reference
---
<ComponentPreview styleName="base-nova" name="tooltip-demo" />
## Installation
<CodeTabs>
<TabsList>
<TabsTrigger value="cli">Command</TabsTrigger>
<TabsTrigger value="manual">Manual</TabsTrigger>
</TabsList>
<TabsContent value="cli">
```bash
npx shadcn@latest add tooltip
```
</TabsContent>
<TabsContent value="manual">
<Steps className="mb-0 pt-2">
<Step>Install the following dependencies:</Step>
```bash
npm install @base-ui/react
```
<Step>Copy and paste the following code into your project.</Step>
<ComponentSource
name="tooltip"
title="components/ui/tooltip.tsx"
styleName="base-nova"
/>
<Step>Update the import paths to match your project setup.</Step>
</Steps>
</TabsContent>
</CodeTabs>
## Usage
```tsx showLineNumbers
import {
Tooltip,
TooltipContent,
TooltipTrigger,
} from "@/components/ui/tooltip"
```
```tsx showLineNumbers
<Tooltip>
<TooltipTrigger>Hover</TooltipTrigger>
<TooltipContent>
<p>Add to library</p>
</TooltipContent>
</Tooltip>
```
## Examples
### Side
Use the `side` prop to change the position of the tooltip.
<ComponentPreview styleName="base-nova" name="tooltip-sides" />
### With Keyboard Shortcut
<ComponentPreview styleName="base-nova" name="tooltip-keyboard" />
### Disabled Button
Show a tooltip on a disabled button by wrapping it with a span.
<ComponentPreview styleName="base-nova" name="tooltip-disabled" />
## API Reference
See the [Base UI Tooltip](https://base-ui.com/react/components/tooltip#api-reference) documentation.