# Hover Card

Displays rich content in a portal when hovering over a trigger.

> For the complete documentation index, see [llms.txt](/llms.txt). Markdown variants are available by appending `.md` to any URL or sending an `Accept: text/markdown` header. An agent skill is available at [/.well-known/agent-skills/site-skill.md](/.well-known/agent-skills/site-skill.md).

<ComponentPreview name="hover-card" title="hover-card-demo.tsx">
<Component />
</ComponentPreview>

Hover Card shows rich content when the user hovers over a trigger. It opens after a short delay, stays open while the pointer is over the card, and closes on mouse leave. Hovering also works on keyboard focus.

## Installation [#installation]

<CodeTabs>
<TabsList>
<TabsTrigger value="cli">
Command
</TabsTrigger>

<TabsTrigger value="manual">
Manual
</TabsTrigger>
</TabsList>

<TabsContent value="cli">
```bash
npx frakment add hover-card
```
</TabsContent>

<TabsContent value="manual">
<Steps>
<Step>
Copy and paste the following code into your project.
</Step>

<ComponentSource name="hover-card" title="components/ui/hover-card.tsx" />

<Step>
Update the import paths to match your project setup.
</Step>
</Steps>
</TabsContent>
</CodeTabs>

## Usage [#usage]

```tsx title="hover-card.tsx"
import {
<DocsBaseSwitcher base="web" component="hover-card" className="mb-6" />
  HoverCard,
  HoverCardContent,
  HoverCardTrigger,
} from "@/components/ui/hover-card";

<HoverCard>
  <HoverCardTrigger as={Button} variant="link">Hover Here</HoverCardTrigger>
  <HoverCardContent>
    Rich content goes here.
  </HoverCardContent>
</HoverCard>
```

## Sides [#sides]

Set `side` on `HoverCardContent` to control placement.

<ComponentPreview name="hover-card-sides" title="hover-card-sides.tsx" src="examples/hover-card-sides.tsx">
<l />
</ComponentPreview>

## Delay [#delay]

Pass `openDelay` and `closeDelay` to `HoverCard` to tune the timing. Defaults are 700ms open, 300ms close.

```tsx
<HoverCard openDelay={100} closeDelay={100}>
  <HoverCardTrigger as={Button}>Trigger</HoverCardTrigger>
  <HoverCardContent>...</HoverCardContent>
</HoverCard>
```

## In Context [#in-context]

### Avatar preview [#avatar-preview]

<ComponentPreview name="hover-card-avatar" title="hover-card-avatar.tsx" src="examples/hover-card-avatar.tsx">
<HoverCardAvatar />
</ComponentPreview>

## API Reference [#api-reference]

### HoverCard [#hovercard]

Extends Radix `HoverCard.Root`.

<PropsTable rows={[{"name":"open","type":"boolean","description":"Controlled open state."},{"name":"defaultOpen","type":"boolean","default":"false","description":"Uncontrolled initial state."},{"name":"onOpenChange","type":"(open: boolean) => void","description":"Fires when the card opens or closes."},{"name":"openDelay","type":"number","default":"700","description":"Milliseconds before opening on hover."},{"name":"closeDelay","type":"number","default":"300","description":"Milliseconds before closing."}]} />

### HoverCardTrigger [#hovercardtrigger]

Extends Radix `HoverCard.Trigger`. Use `as` to compose with a Button, Link, or any focusable element.

### HoverCardContent [#hovercardcontent]

Extends Radix `HoverCard.Content`. Renders inside a portal.

<PropsTable rows={[{"name":"side","type":"\"top\" | \"right\" | \"bottom\" | \"left\"","default":"\"bottom\"","description":"Placement relative to the trigger."},{"name":"align","type":"\"start\" | \"center\" | \"end\"","default":"\"center\"","description":"Alignment along the chosen side."},{"name":"sideOffset","type":"number","default":"4","description":"Gap in pixels between trigger and card."}]} />

## Controlled [#controlled]

```tsx
const [open, setOpen] = React.useState(false)
<HoverCard open={open} onOpenChange={setOpen}>{/* ... */}</HoverCard>
```

## Data Attributes [#data-attributes]

| Attribute | Values |
| :-- | :-- |
| `data-slot` | `hover-card-trigger`, `hover-card-content` |
| `data-state` | `open` \| `closed` |
| `data-side` | `top` \| `right` \| `bottom` \| `left` |
| `data-align` | `start` \| `center` \| `end` |

## Accessibility [#accessibility]

## Accessibility [#accessibility-1]

- Hover Card is pointer-driven. Do not put interactive content inside it, use Dialog, Popover, or Dropdown Menu for that.
- Hover Card also opens on keyboard focus. Make sure the trigger is a focusable element such as `<button>` or `<a>`.
- Provide a visible text label on the trigger so keyboard and screen reader users understand what it does.

## Composition [#composition]

```text
HoverCard
├── HoverCardTrigger
└── HoverCardContent
```

## Best Practices [#best-practices]

- **Keep content short.** Two or three lines.
- **Do not put interactive content inside.** Hover Card is pointer-driven.
- **Use for preview, not action.** Show metadata, not forms.
- **Add a visible trigger label.** Screen readers rely on trigger text.
## Related Components [#related-components]

- [Tooltip](/docs/components/tooltip) — short text hint
- [Popover](/docs/components/hover-card) — click-triggered