Skip to main content

Overview

@badrinteractive
B
Badr Interactive
@badrinteractive
Designing and building the A’raf Design System. Jakarta, Indonesia 🇮🇩
128 following4.2k followers
Hover Card reveals supplementary content when the user hovers over a trigger element. Unlike 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


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 · left
string
default:"center"
Alignment relative to the trigger. Values: start · center · end
number
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 focus trigger for keyboard users
  • Never put interactive elements (buttons, links) inside a Hover Card — use Popover for 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