Hover Card
Card that appears on hover for previewing content. Install Hover Card from the VLLNT UI registry with the shadcn CLI.
What it is and 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.
OverlayCard that appears on hover for previewing content. Part of the overlay family in VLLNT UI, it ships as a machine-readable registry entry — copy the source directly into your app with the shadcn CLI and own it, no runtime dependency on a component library.
Preview
Switch between light and dark to inspect the embedded Storybook preview.
Installation
Add Hover Card to your project with the shadcn CLI. The source lands in your codebase, ready to adapt:
pnpm dlx shadcn@latest add https://ui.vllnt.com/r/hover-card.jsonSource
"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 };
Stories
Explore every variant and state in the interactive Storybook:
Preview
Switch between light and dark to inspect the embedded Storybook preview.
FAQ
- 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.