Overview
@badrinteractive
B
Badr Interactive
@badrinteractive
Designing and building the A’raf Design System. Jakarta, Indonesia 🇮🇩
128 following4.2k followers
Tooltip (text-only, immediate), Hover Card supports rich content and has a short open delay — ideal for user avatars, social handles, and link previews.
Installation
Usage
Variants
User Profile Preview
Link Preview
API Reference
HoverCard
boolean
Controlled open state.
(open: boolean) => void
Callback when open state changes.
number
default:"700"
Milliseconds before the card opens after hover starts.
number
default:"300"
Milliseconds before the card closes after hover ends.
HoverCardContent
string
default:"bottom"
Which side of the trigger to render on. Values:
top · right · bottom · leftstring
default:"center"
Alignment relative to the trigger. Values:
start · center · endnumber
default:"4"
Distance in px between trigger and card.
Accessibility
- Hover Card is purely supplementary — all content inside must also be accessible without hovering
- It is not keyboard accessible by default (hover only) — consider adding a
focustrigger for keyboard users - Never put interactive elements (buttons, links) inside a Hover Card — use
Popoverfor that - Screen readers ignore Hover Card content — do not put essential information in it
Do’s & Don’ts
Do
- Use for supplementary previews: user profiles, link previews, tag definitions
- Set an appropriate
openDelay(300–700ms) to avoid accidental triggers - Keep content concise — Hover Card is a preview, not a full detail page
- Use
side="bottom"(default) for inline text triggers
Don't
- Don’t put interactive elements (buttons, forms) inside — use
Popover - Don’t rely on Hover Card for essential information — hover is not available on touch devices
- Don’t use on mobile-primary experiences — hover doesn’t exist on touchscreens
- Don’t set
openDelay={0}— it triggers too easily on mouse movement