Hover Card
Show a rich preview card when users hover a link or name in React. Accessible Radix Hover Card with configurable align and offset. Install via the shadcn CLI.
What it is & when to use
Hover Card is a popover built on Radix UI's Hover Card primitive that reveals extra content when a pointer hovers a trigger. Compose it from HoverCard, HoverCardTrigger, and HoverCardContent, which renders a bordered card with configurable align and side offset. Use it to preview linked content — a user profile, a repository, or a footnote — without a click or navigation. Unlike a tooltip, it holds rich layout and media and opens on hover or focus of its trigger.
Browse all OverlayPreview
Switch between light and dark to inspect the embedded Storybook preview.
Installation
pnpm dlx shadcn@latest add https://ui.vllnt.com/r/hover-card.jsonStorybook
Explore all variants, controls, and accessibility checks in the interactive Storybook playground.
View in StorybookCode
"use client";
import * as HoverCardPrimitive from "@radix-ui/react-hover-card";
import { cn } from "../../lib/utils";
const HoverCard = HoverCardPrimitive.Root;
const HoverCardTrigger = HoverCardPrimitive.Trigger;
const HoverCardContent = ({
align = "center",
className,
ref,
sideOffset = 4,
...props
}: React.ComponentPropsWithoutRef<typeof HoverCardPrimitive.Content> & {
ref?: React.Ref<React.ComponentRef<typeof HoverCardPrimitive.Content>>;
}) => (
<HoverCardPrimitive.Content
align={align}
className={cn(
"z-50 w-64 rounded-md border bg-popover p-4 text-popover-foreground shadow-md outline-none data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2",
className,
)}
ref={ref}
sideOffset={sideOffset}
{...props}
/>
);
HoverCardContent.displayName = HoverCardPrimitive.Content.displayName;
export { HoverCard, HoverCardContent, HoverCardTrigger };
Frequently asked questions
- What is Hover Card?
- Hover Card is a React component, built on Radix UI's Hover Card primitive, that shows a floating card of rich content when a pointer hovers its trigger.
- How do I add Hover Card?
- Run pnpm dlx shadcn@latest add https://ui.vllnt.com/r/hover-card.json to copy the source into your project, then import HoverCard, HoverCardTrigger, and HoverCardContent.
- How is Hover Card different from a tooltip?
- A tooltip shows short text on hover or focus; Hover Card renders a full bordered card with layout and media, opens on hover or focus with configurable delays, and suits previews like profiles.