Get Started
Components
- Accordion
- Attachment
- Avatar
- Badge
- Breadcrumb
- Button
- Button Group
- Card
- Checkbox
- Code Block
- Collapsible
- Dialog
- Dropdown Menu
- Empty
- Field
- Hover Card
- Input
- Input Group
- Input OTP
- Item
- Label
- Marker
- Message
- Number Flow
- Pagination
- Popover
- Progress
- Radio Group
- Select
- Slider
- Sonner
- Spinner
- Switch
- Tooltip
- Separator
- Sheet
- Tabs
- Textarea
- Toggle
- Toggle Group
- Trace
AI Elements
Libraries
Utilities
"use client";
import * as React from "react";
import { createPortal } from "react-dom";
import { cn } from "@/lib/utils";
type Side = "top" | "right" | "bottom" | "left";
type Align = "start" | "center" | "end";
interface HoverCardContextValue {
contentRef: React.RefObject<HTMLDivElement | null>;
open: boolean;
scheduleClose: () => void;
scheduleOpen: () => void;
setOpen: (open: boolean) => void;
triggerRef: React.RefObject<HTMLElement | null>;
}
const HoverCardContext = React.createContext<HoverCardContextValue | null>(
null
);
function useHoverCardContext(): HoverCardContextValue {
const ctx = React.useContext(HoverCardContext);
if (!ctx) {
throw new Error("HoverCard components must be used within <HoverCard>.");
}
return ctx;
}
interface HoverCardProps {
children?: React.ReactNode;
closeDelay?: number;
defaultOpen?: boolean;
onOpenChange?: (open: boolean) => void;
open?: boolean;
openDelay?: number;
}
function HoverCard({
children,
open: openProp,
defaultOpen = false,
onOpenChange,
openDelay = 700,
closeDelay = 300,
}: HoverCardProps) {
const isControlled = openProp !== undefined;
const [uncontrolled, setUncontrolled] = React.useState(defaultOpen);
const open = isControlled ? openProp : uncontrolled;
const triggerRef = React.useRef<HTMLElement | null>(null);
const contentRef = React.useRef<HTMLDivElement | null>(null);
const openTimerRef = React.useRef<number | null>(null);
const closeTimerRef = React.useRef<number | null>(null);
const clearTimers = React.useCallback(() => {
if (openTimerRef.current !== null) {
window.clearTimeout(openTimerRef.current);
openTimerRef.current = null;
}
if (closeTimerRef.current !== null) {
window.clearTimeout(closeTimerRef.current);
closeTimerRef.current = null;
}
}, []);
const setOpen = React.useCallback(
(next: boolean) => {
if (!isControlled) {
setUncontrolled(next);
}
onOpenChange?.(next);
},
[isControlled, onOpenChange]
);
const scheduleOpen = React.useCallback(() => {
if (closeTimerRef.current !== null) {
window.clearTimeout(closeTimerRef.current);
closeTimerRef.current = null;
}
if (open) {
return;
}
openTimerRef.current = window.setTimeout(() => {
openTimerRef.current = null;
setOpen(true);
}, openDelay);
}, [open, openDelay, setOpen]);
const scheduleClose = React.useCallback(() => {
if (openTimerRef.current !== null) {
window.clearTimeout(openTimerRef.current);
openTimerRef.current = null;
}
if (!open) {
return;
}
closeTimerRef.current = window.setTimeout(() => {
closeTimerRef.current = null;
setOpen(false);
}, closeDelay);
}, [open, closeDelay, setOpen]);
React.useEffect(() => clearTimers, [clearTimers]);
const ctx = React.useMemo<HoverCardContextValue>(
() => ({
contentRef,
open,
scheduleClose,
scheduleOpen,
setOpen,
triggerRef,
}),
[open, setOpen, scheduleOpen, scheduleClose]
);
return (
<HoverCardContext.Provider value={ctx}>
{children}
</HoverCardContext.Provider>
);
}
type HoverCardTriggerProps = Omit<
React.ComponentPropsWithoutRef<"button">,
"ref"
> &
Record<string, unknown> & {
as?: React.ElementType;
asChild?: boolean;
ref?: React.Ref<HTMLElement>;
};
function HoverCardTrigger({
as,
asChild,
children,
onBlur,
onFocus,
onPointerEnter,
onPointerLeave,
ref,
...props
}: HoverCardTriggerProps) {
const ctx = useHoverCardContext();
const setRef = React.useCallback(
(node: HTMLElement | null) => {
ctx.triggerRef.current = node;
if (typeof ref === "function") {
ref(node);
} else if (ref) {
(ref as React.MutableRefObject<HTMLElement | null>).current = node;
}
},
[ctx.triggerRef, ref]
);
const handlers = {
onBlur: (e: React.FocusEvent<HTMLElement>) => {
onBlur?.(e as never);
if (!e.defaultPrevented) {
ctx.scheduleClose();
}
},
onFocus: (e: React.FocusEvent<HTMLElement>) => {
onFocus?.(e as never);
if (!e.defaultPrevented) {
ctx.scheduleOpen();
}
},
onPointerEnter: (e: React.PointerEvent<HTMLElement>) => {
onPointerEnter?.(e as never);
if (!e.defaultPrevented) {
ctx.scheduleOpen();
}
},
onPointerLeave: (e: React.PointerEvent<HTMLElement>) => {
onPointerLeave?.(e as never);
if (!e.defaultPrevented) {
ctx.scheduleClose();
}
},
};
const state = ctx.open ? "open" : "closed";
if (asChild && React.isValidElement(children)) {
const child = children as React.ReactElement<Record<string, unknown>>;
return React.cloneElement(child, {
...props,
...handlers,
"data-slot": "hover-card-trigger",
"data-state": state,
ref: setRef,
} as never);
}
const Component = (as ?? "button") as React.ElementType;
const isNativeButton = !as;
return (
<Component
data-slot="hover-card-trigger"
data-state={state}
{...props}
{...(isNativeButton ? { type: "button" as const } : {})}
{...handlers}
ref={setRef}
>
{children}
</Component>
);
}
type HoverCardContentProps = React.ComponentPropsWithoutRef<"div"> & {
align?: Align;
side?: Side;
sideOffset?: number;
ref?: React.Ref<HTMLDivElement>;
};
interface Position {
left: number;
side: Side;
top: number;
}
function computePosition(
trigger: HTMLElement,
content: HTMLElement,
side: Side,
align: Align,
offset: number
): Position {
const t = trigger.getBoundingClientRect();
const c = content.getBoundingClientRect();
const vw = window.innerWidth;
const vh = window.innerHeight;
let actualSide: Side = side;
if (
side === "bottom" &&
t.bottom + offset + c.height > vh &&
t.top > vh - t.bottom
) {
actualSide = "top";
} else if (
side === "top" &&
t.top - offset - c.height < 0 &&
vh - t.bottom > t.top
) {
actualSide = "bottom";
} else if (
side === "right" &&
t.right + offset + c.width > vw &&
t.left > vw - t.right
) {
actualSide = "left";
} else if (
side === "left" &&
t.left - offset - c.width < 0 &&
vw - t.right > t.left
) {
actualSide = "right";
}
let top = 0;
let left = 0;
if (actualSide === "bottom") {
top = t.bottom + offset;
} else if (actualSide === "top") {
top = t.top - c.height - offset;
} else if (actualSide === "right") {
top = t.top + (t.height - c.height) / 2;
} else {
top = t.top + (t.height - c.height) / 2;
}
if (actualSide === "bottom" || actualSide === "top") {
if (align === "start") {
left = t.left;
} else if (align === "end") {
left = t.right - c.width;
} else {
left = t.left + (t.width - c.width) / 2;
}
} else if (actualSide === "right") {
left = t.right + offset;
} else {
left = t.left - c.width - offset;
}
left = Math.max(8, Math.min(left, vw - c.width - 8));
top = Math.max(8, Math.min(top, vh - c.height - 8));
return { left, side: actualSide, top };
}
function HoverCardContent({
align = "center",
children,
className,
ref,
side = "bottom",
sideOffset = 4,
style,
...props
}: HoverCardContentProps) {
const ctx = useHoverCardContext();
const { open, setOpen, triggerRef, contentRef, scheduleOpen, scheduleClose } =
ctx;
const [mounted, setMounted] = React.useState(open);
const [pos, setPos] = React.useState<Position>({ left: 0, side, top: 0 });
const setRef = React.useCallback(
(node: HTMLDivElement | null) => {
contentRef.current = node;
if (typeof ref === "function") {
ref(node);
} else if (ref) {
(ref as React.MutableRefObject<HTMLDivElement | null>).current = node;
}
},
[contentRef, ref]
);
const [entered, setEntered] = React.useState(false);
React.useEffect(() => {
if (open) {
setMounted(true);
const raf1 = requestAnimationFrame(() => {
const raf2 = requestAnimationFrame(() => setEntered(true));
return () => cancelAnimationFrame(raf2);
});
return () => cancelAnimationFrame(raf1);
}
setEntered(false);
const timer = window.setTimeout(() => setMounted(false), 100);
return () => window.clearTimeout(timer);
}, [open]);
React.useLayoutEffect(() => {
if (!mounted) {
return;
}
const trigger = triggerRef.current;
const content = contentRef.current;
if (!(trigger && content)) {
return;
}
const update = () =>
setPos(computePosition(trigger, content, side, align, sideOffset));
update();
const ro = new ResizeObserver(update);
ro.observe(trigger);
ro.observe(content);
window.addEventListener("scroll", update, true);
window.addEventListener("resize", update);
return () => {
ro.disconnect();
window.removeEventListener("scroll", update, true);
window.removeEventListener("resize", update);
};
}, [mounted, align, side, sideOffset, triggerRef, contentRef]);
React.useEffect(() => {
if (!open) {
return;
}
const onKey = (e: KeyboardEvent) => {
if (e.key === "Escape") {
setOpen(false);
}
};
document.addEventListener("keydown", onKey);
return () => document.removeEventListener("keydown", onKey);
}, [open, setOpen]);
if (!mounted || typeof document === "undefined") {
return null;
}
return createPortal(
<div
data-side={pos.side}
data-slot="hover-card-content"
data-state={open ? "open" : "closed"}
{...props}
className={cn(
"bg-popover dark:bg-card text-popover-foreground ring-foreground/10 fixed z-50 w-64 rounded-lg p-3 text-sm shadow-sm ring-1 outline-hidden",
className
)}
onPointerEnter={() => scheduleOpen()}
onPointerLeave={() => scheduleClose()}
ref={setRef}
style={{
left: pos.left,
opacity: entered ? 1 : 0,
top: pos.top,
transform: `scale(${entered ? 1 : 0.95})`,
transition: "opacity 100ms ease-out, transform 100ms ease-out",
...style,
}}
>
{children}
</div>,
document.body
);
}
export { HoverCard, HoverCardContent, HoverCardTrigger };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
$ bunx --bun frakment add hover-card$ npx frakment add hover-card$ pnpm dlx frakment add hover-card$ yarn dlx frakment add hover-card
Copy and paste the following code into your project.
"use client";
import * as React from "react";
import { createPortal } from "react-dom";
import { cn } from "@/lib/utils";
type Side = "top" | "right" | "bottom" | "left";
type Align = "start" | "center" | "end";
interface HoverCardContextValue {
contentRef: React.RefObject<HTMLDivElement | null>;
open: boolean;
scheduleClose: () => void;
scheduleOpen: () => void;
setOpen: (open: boolean) => void;
triggerRef: React.RefObject<HTMLElement | null>;
}
const HoverCardContext = React.createContext<HoverCardContextValue | null>(
null
);
function useHoverCardContext(): HoverCardContextValue {
const ctx = React.useContext(HoverCardContext);
if (!ctx) {
throw new Error("HoverCard components must be used within <HoverCard>.");
}
return ctx;
}
interface HoverCardProps {
children?: React.ReactNode;
closeDelay?: number;
defaultOpen?: boolean;
onOpenChange?: (open: boolean) => void;
open?: boolean;
openDelay?: number;
}
function HoverCard({
children,
open: openProp,
defaultOpen = false,
onOpenChange,
openDelay = 700,
closeDelay = 300,
}: HoverCardProps) {
const isControlled = openProp !== undefined;
const [uncontrolled, setUncontrolled] = React.useState(defaultOpen);
const open = isControlled ? openProp : uncontrolled;
const triggerRef = React.useRef<HTMLElement | null>(null);
const contentRef = React.useRef<HTMLDivElement | null>(null);
const openTimerRef = React.useRef<number | null>(null);
const closeTimerRef = React.useRef<number | null>(null);
const clearTimers = React.useCallback(() => {
if (openTimerRef.current !== null) {
window.clearTimeout(openTimerRef.current);
openTimerRef.current = null;
}
if (closeTimerRef.current !== null) {
window.clearTimeout(closeTimerRef.current);
closeTimerRef.current = null;
}
}, []);
const setOpen = React.useCallback(
(next: boolean) => {
if (!isControlled) {
setUncontrolled(next);
}
onOpenChange?.(next);
},
[isControlled, onOpenChange]
);
const scheduleOpen = React.useCallback(() => {
if (closeTimerRef.current !== null) {
window.clearTimeout(closeTimerRef.current);
closeTimerRef.current = null;
}
if (open) {
return;
}
openTimerRef.current = window.setTimeout(() => {
openTimerRef.current = null;
setOpen(true);
}, openDelay);
}, [open, openDelay, setOpen]);
const scheduleClose = React.useCallback(() => {
if (openTimerRef.current !== null) {
window.clearTimeout(openTimerRef.current);
openTimerRef.current = null;
}
if (!open) {
return;
}
closeTimerRef.current = window.setTimeout(() => {
closeTimerRef.current = null;
setOpen(false);
}, closeDelay);
}, [open, closeDelay, setOpen]);
React.useEffect(() => clearTimers, [clearTimers]);
const ctx = React.useMemo<HoverCardContextValue>(
() => ({
contentRef,
open,
scheduleClose,
scheduleOpen,
setOpen,
triggerRef,
}),
[open, setOpen, scheduleOpen, scheduleClose]
);
return (
<HoverCardContext.Provider value={ctx}>
{children}
</HoverCardContext.Provider>
);
}
type HoverCardTriggerProps = Omit<
React.ComponentPropsWithoutRef<"button">,
"ref"
> &
Record<string, unknown> & {
as?: React.ElementType;
asChild?: boolean;
ref?: React.Ref<HTMLElement>;
};
function HoverCardTrigger({
as,
asChild,
children,
onBlur,
onFocus,
onPointerEnter,
onPointerLeave,
ref,
...props
}: HoverCardTriggerProps) {
const ctx = useHoverCardContext();
const setRef = React.useCallback(
(node: HTMLElement | null) => {
ctx.triggerRef.current = node;
if (typeof ref === "function") {
ref(node);
} else if (ref) {
(ref as React.MutableRefObject<HTMLElement | null>).current = node;
}
},
[ctx.triggerRef, ref]
);
const handlers = {
onBlur: (e: React.FocusEvent<HTMLElement>) => {
onBlur?.(e as never);
if (!e.defaultPrevented) {
ctx.scheduleClose();
}
},
onFocus: (e: React.FocusEvent<HTMLElement>) => {
onFocus?.(e as never);
if (!e.defaultPrevented) {
ctx.scheduleOpen();
}
},
onPointerEnter: (e: React.PointerEvent<HTMLElement>) => {
onPointerEnter?.(e as never);
if (!e.defaultPrevented) {
ctx.scheduleOpen();
}
},
onPointerLeave: (e: React.PointerEvent<HTMLElement>) => {
onPointerLeave?.(e as never);
if (!e.defaultPrevented) {
ctx.scheduleClose();
}
},
};
const state = ctx.open ? "open" : "closed";
if (asChild && React.isValidElement(children)) {
const child = children as React.ReactElement<Record<string, unknown>>;
return React.cloneElement(child, {
...props,
...handlers,
"data-slot": "hover-card-trigger",
"data-state": state,
ref: setRef,
} as never);
}
const Component = (as ?? "button") as React.ElementType;
const isNativeButton = !as;
return (
<Component
data-slot="hover-card-trigger"
data-state={state}
{...props}
{...(isNativeButton ? { type: "button" as const } : {})}
{...handlers}
ref={setRef}
>
{children}
</Component>
);
}
type HoverCardContentProps = React.ComponentPropsWithoutRef<"div"> & {
align?: Align;
side?: Side;
sideOffset?: number;
ref?: React.Ref<HTMLDivElement>;
};
interface Position {
left: number;
side: Side;
top: number;
}
function computePosition(
trigger: HTMLElement,
content: HTMLElement,
side: Side,
align: Align,
offset: number
): Position {
const t = trigger.getBoundingClientRect();
const c = content.getBoundingClientRect();
const vw = window.innerWidth;
const vh = window.innerHeight;
let actualSide: Side = side;
if (
side === "bottom" &&
t.bottom + offset + c.height > vh &&
t.top > vh - t.bottom
) {
actualSide = "top";
} else if (
side === "top" &&
t.top - offset - c.height < 0 &&
vh - t.bottom > t.top
) {
actualSide = "bottom";
} else if (
side === "right" &&
t.right + offset + c.width > vw &&
t.left > vw - t.right
) {
actualSide = "left";
} else if (
side === "left" &&
t.left - offset - c.width < 0 &&
vw - t.right > t.left
) {
actualSide = "right";
}
let top = 0;
let left = 0;
if (actualSide === "bottom") {
top = t.bottom + offset;
} else if (actualSide === "top") {
top = t.top - c.height - offset;
} else if (actualSide === "right") {
top = t.top + (t.height - c.height) / 2;
} else {
top = t.top + (t.height - c.height) / 2;
}
if (actualSide === "bottom" || actualSide === "top") {
if (align === "start") {
left = t.left;
} else if (align === "end") {
left = t.right - c.width;
} else {
left = t.left + (t.width - c.width) / 2;
}
} else if (actualSide === "right") {
left = t.right + offset;
} else {
left = t.left - c.width - offset;
}
left = Math.max(8, Math.min(left, vw - c.width - 8));
top = Math.max(8, Math.min(top, vh - c.height - 8));
return { left, side: actualSide, top };
}
function HoverCardContent({
align = "center",
children,
className,
ref,
side = "bottom",
sideOffset = 4,
style,
...props
}: HoverCardContentProps) {
const ctx = useHoverCardContext();
const { open, setOpen, triggerRef, contentRef, scheduleOpen, scheduleClose } =
ctx;
const [mounted, setMounted] = React.useState(open);
const [pos, setPos] = React.useState<Position>({ left: 0, side, top: 0 });
const setRef = React.useCallback(
(node: HTMLDivElement | null) => {
contentRef.current = node;
if (typeof ref === "function") {
ref(node);
} else if (ref) {
(ref as React.MutableRefObject<HTMLDivElement | null>).current = node;
}
},
[contentRef, ref]
);
const [entered, setEntered] = React.useState(false);
React.useEffect(() => {
if (open) {
setMounted(true);
const raf1 = requestAnimationFrame(() => {
const raf2 = requestAnimationFrame(() => setEntered(true));
return () => cancelAnimationFrame(raf2);
});
return () => cancelAnimationFrame(raf1);
}
setEntered(false);
const timer = window.setTimeout(() => setMounted(false), 100);
return () => window.clearTimeout(timer);
}, [open]);
React.useLayoutEffect(() => {
if (!mounted) {
return;
}
const trigger = triggerRef.current;
const content = contentRef.current;
if (!(trigger && content)) {
return;
}
const update = () =>
setPos(computePosition(trigger, content, side, align, sideOffset));
update();
const ro = new ResizeObserver(update);
ro.observe(trigger);
ro.observe(content);
window.addEventListener("scroll", update, true);
window.addEventListener("resize", update);
return () => {
ro.disconnect();
window.removeEventListener("scroll", update, true);
window.removeEventListener("resize", update);
};
}, [mounted, align, side, sideOffset, triggerRef, contentRef]);
React.useEffect(() => {
if (!open) {
return;
}
const onKey = (e: KeyboardEvent) => {
if (e.key === "Escape") {
setOpen(false);
}
};
document.addEventListener("keydown", onKey);
return () => document.removeEventListener("keydown", onKey);
}, [open, setOpen]);
if (!mounted || typeof document === "undefined") {
return null;
}
return createPortal(
<div
data-side={pos.side}
data-slot="hover-card-content"
data-state={open ? "open" : "closed"}
{...props}
className={cn(
"bg-popover dark:bg-card text-popover-foreground ring-foreground/10 fixed z-50 w-64 rounded-lg p-3 text-sm shadow-sm ring-1 outline-hidden",
className
)}
onPointerEnter={() => scheduleOpen()}
onPointerLeave={() => scheduleClose()}
ref={setRef}
style={{
left: pos.left,
opacity: entered ? 1 : 0,
top: pos.top,
transform: `scale(${entered ? 1 : 0.95})`,
transition: "opacity 100ms ease-out, transform 100ms ease-out",
...style,
}}
>
{children}
</div>,
document.body
);
}
export { HoverCard, HoverCardContent, HoverCardTrigger };Update the import paths to match your project setup.
Usage
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
Set side on HoverCardContent to control placement.
import { Button } from "@/components/ui/button";
import {
HoverCard,
HoverCardContent,
HoverCardTrigger,
} from "@/components/ui/hover-card";
const HOVER_CARD_SIDES = ["left", "top", "bottom", "right"] as const;
export function HoverCardSides() {
return (
<div className="flex flex-wrap justify-center gap-2">
{HOVER_CARD_SIDES.map((side) => (
<HoverCard closeDelay={100} key={side} openDelay={100}>
<HoverCardTrigger
as={Button}
className="capitalize"
variant="outline"
>
{side}
</HoverCardTrigger>
<HoverCardContent side={side}>
<div className="flex flex-col gap-1">
<h4 className="font-medium">Hover Card</h4>
<p>This hover card appears on the {side} side of the trigger.</p>
</div>
</HoverCardContent>
</HoverCard>
))}
</div>
);
}Delay
Pass openDelay and closeDelay to HoverCard to tune the timing. Defaults are 700ms open, 300ms close.
<HoverCard openDelay={100} closeDelay={100}>
<HoverCardTrigger as={Button}>Trigger</HoverCardTrigger>
<HoverCardContent>...</HoverCardContent>
</HoverCard>In Context
Avatar preview
"use client";
import {
HoverCard,
HoverCardContent,
HoverCardTrigger,
} from "@/components/ui/hover-card";
export function HoverCardAvatar() {
return (
<div className="mx-auto flex items-center justify-center">
<HoverCard closeDelay={100} openDelay={50}>
<HoverCardTrigger as="button" className="rounded-full" type="button">
<span className="bg-muted flex size-10 items-center justify-center rounded-full text-sm font-medium">
AR
</span>
</HoverCardTrigger>
<HoverCardContent className="w-72">
<div className="flex flex-col gap-1">
<span className="font-semibold">Arya Rahman</span>
<span className="text-muted-foreground text-sm">@johndoe</span>
<p className="mt-2 text-sm">Building Frakment.</p>
</div>
</HoverCardContent>
</HoverCard>
</div>
);
}API Reference
HoverCard
Extends Radix HoverCard.Root.
| Prop | Type | Default | Description |
|---|---|---|---|
open | boolean | — | Controlled open state. |
defaultOpen | boolean | false | Uncontrolled initial state. |
onOpenChange | (open: boolean) => void | — | Fires when the card opens or closes. |
openDelay | number | 700 | Milliseconds before opening on hover. |
closeDelay | number | 300 | Milliseconds before closing. |
HoverCardTrigger
Extends Radix HoverCard.Trigger. Use as to compose with a Button, Link, or any focusable element.
HoverCardContent
Extends Radix HoverCard.Content. Renders inside a portal.
| Prop | Type | Default | Description |
|---|---|---|---|
side | "top""right""bottom""left" | "bottom" | Placement relative to the trigger. |
align | "start""center""end" | "center" | Alignment along the chosen side. |
sideOffset | number | 4 | Gap in pixels between trigger and card. |
Controlled
const [open, setOpen] = React.useState(false)
<HoverCard open={open} onOpenChange={setOpen}>{/* ... */}</HoverCard>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
- 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
HoverCard
├── HoverCardTrigger
└── HoverCardContentBest 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.