Skip to content

shadcn.io is an independent project built on shadcn/ui

Free

Profile with Location Hover Card for React

The handle @haydenbleasel opens a wider profile with a bio, San Francisco, and Joined 2020.

The trigger is @haydenbleasel. The card shows a large avatar, Hayden Bleasel, the handle, a short bio, a pin for San Francisco, and Joined 2020.

It belongs in a community when place and tenure matter. If it must open on a tap, use a Popover. In React, Base UI does not look up the city. That line is text in the card.

Preview

Preview width

Installation

Sign in to get your install command
Free with an account. It carries your token, so the CLI installs everything in one go.

Anatomy

Hover Card anatomy: trigger, positioner, arrow, content

Usage

<HoverCard>
  <HoverCardTrigger
    className="font-medium text-sm underline underline-offset-4"
    closeDelay={100}
    delay={10}
    href="#"
  >
    @haydenbleasel
  </HoverCardTrigger>
  <HoverCardContent className="w-80 max-w-full">
    <div className="flex gap-4">
      <Avatar size="lg">
        <AvatarImage
          alt="@haydenbleasel"
          height={40}
          src="https://github.com/haydenbleasel.png"
          width={40}
        />
        <AvatarFallback>HB</AvatarFallback>
      </Avatar>
      <div className="flex flex-1 flex-col gap-2">
        <div>
          <h4 className="font-semibold text-sm">Hayden Bleasel</h4>
          <p className="text-muted-foreground text-sm">@haydenbleasel</p>
        </div>
        <p className="text-sm">
          Product designer and developer building tools for creators.
        </p>
        <div className="flex items-center gap-4 text-muted-foreground text-xs">
          <div className="flex items-center gap-1">
            <MapPinIcon aria-hidden="true" className="size-3" />
{/* The rest of the file is under Installation. */}

FAQ

What is in the card?

A large Avatar, Hayden Bleasel and @haydenbleasel, the bio, then a pin with San Francisco and a calendar with Joined 2020.

How is the username link made the trigger?

HoverCardTrigger renders an anchor itself, so the username link is the trigger with href and its classes set on it.

How is the avatar made large?

size="lg" on Avatar. The image has the username as its alt, and AvatarFallback shows HB if it fails to load.

How wide is the card?

w-80 on the card, for the extra content. The class is on HoverCardContent. max-w-full keeps it inside narrow screens.

How do I change how fast the card opens and closes?

The card opens a moment after the pointer rests on the trigger and stays up long enough for the pointer to move into it. Both delays are in milliseconds. The demo sets delay 10 and closeDelay 100 on HoverCardTrigger. side and align on HoverCardContent place it.

Does the card open from the keyboard and on touch screens?

Focusing the username opens the card, moving focus away or pressing Escape closes it. Touch screens have no hover, so keep what matters reachable elsewhere, or use a Popover when the card has to open on a tap.

API Reference

Hover Card

Sets closeDelay={100}, delay={10} and href="#". The rest is on the Hover Card page.

Avatar

Sets size="lg", alt="@haydenbleasel", height={40}, src="https://github.com/haydenbleasel.png" and width={40}. The rest is on the Avatar page.