پرش به محتوا

کارت شناور

پیش‌نمایش شناور که با hover باز می‌شود — نگاهی به پروفایل، پیش‌نمایش لینک‌ها، اصطلاحات واژه‌نامه — با جلوه‌ی neobrutalist مرزها و سایه‌ها.

import {
  Avatar,
  AvatarFallback,

Hover card هنگام قرار گرفتن اشاره‌گر روی تریگر — بدون نیاز به کلیک — پنلی از محتوای پیش‌نمایش غنی را روی صفحه شناور می‌کند. بر پایهٔ Base UI Preview Card ساخته شده و با دستور پخت نئوبروتالیستی استایل شده: حاشیه‌های ضخیم، سایه‌های سخت و تایپوگرافی پررنگ.

برای این موارد از آن استفاده کنید:

  • نگاه سریع پروفایل — روی @mention یا آواتار hover کنید تا bio، آمار و دکمهٔ follow دیده شود.
  • پیش‌نمایش لینک — عنوان و خلاصهٔ صفحه را قبل از تعهد به کلیک نشان دهید.
  • اصطلاح glossary — jargon را در docs بدون ترک صفحه تعریف کنید.

نصب

pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/hover-card.json
npx shadcn@latest add https://neobrutalism.com/r/base/hover-card.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/hover-card.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/hover-card.json

وابستگی‌های زیر را نصب کنید:

pnpm add @base-ui/react
npm install @base-ui/react
yarn add @base-ui/react
bun add @base-ui/react

کد زیر را کپی کرده و در پروژهٔ خود جای‌گذاری کنید.

components/ui/hover-card.tsx
"use client"

import * as React from "react"
import { HoverCard as HoverCardPrimitive } from "radix-ui"

import { cn } from "@/lib/utils"

function HoverCard({
  ...props
}: React.ComponentProps<typeof HoverCardPrimitive.Root>) {
  return <HoverCardPrimitive.Root data-slot="hover-card" {...props} />
}

function HoverCardTrigger({
  ...props
}: React.ComponentProps<typeof HoverCardPrimitive.Trigger>) {
  return (
    <HoverCardPrimitive.Trigger data-slot="hover-card-trigger" {...props} />
  )
}

function HoverCardContent({
  className,
  align = "center",
  sideOffset = 4,
  ...props
}: React.ComponentProps<typeof HoverCardPrimitive.Content>) {
  return (
    <HoverCardPrimitive.Portal data-slot="hover-card-portal">
      <HoverCardPrimitive.Content
        data-slot="hover-card-content"
        align={align}
        sideOffset={sideOffset}
        className={cn(
          "z-50 w-64 origin-(--radix-hover-card-content-transform-origin) rounded border-2 bg-popover p-2.5 text-sm text-popover-foreground shadow-md outline-hidden duration-100 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 data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95",
          className
        )}
        {...props}
      />
    </HoverCardPrimitive.Portal>
  )
}

export { HoverCard, HoverCardTrigger, HoverCardContent }

مسیرهای import را مطابق با پیکربندی پروژهٔ خود به‌روزرسانی کنید.

استفاده

import {
  HoverCard,
  HoverCardContent,
  HoverCardTrigger,
} from "@/components/ui/hover-card"
<HoverCard>
  <HoverCardTrigger>Hover</HoverCardTrigger>
  <HoverCardContent>
    The React Framework – created and maintained by @vercel.
  </HoverCardContent>
</HoverCard>

ترکیب

برای ساخت یک HoverCard از ترکیب زیر استفاده کنید:

HoverCard
├── HoverCardTrigger
└── HoverCardContent

تأخیرهای تریگر

برای کنترل زمان باز و بسته شدن کارت از delay و closeDelay روی تریگر استفاده کنید.

<HoverCard>
  <HoverCardTrigger delay={100} closeDelay={200}>
    Hover
  </HoverCardTrigger>
  <HoverCardContent>Content</HoverCardContent>
</HoverCard>

موقعیت‌دهی

برای کنترل مکان از prop‌های side و align روی HoverCardContent استفاده کنید.

<HoverCard>
  <HoverCardTrigger>Hover</HoverCardTrigger>
  <HoverCardContent side="top" align="start">
    Content
  </HoverCardContent>
</HoverCard>

نمونه‌ها

پایه

import {
  Avatar,
  AvatarFallback,

جهت‌ها

import { Button } from "@/components/ui/button"
import {
  HoverCard,

RTL

برای فعال‌سازی پشتیبانی RTL در Neobrutalism، راهنمای پیکربندی RTL را ببینید.

"use client"

import {

دسترسی‌پذیری

Hover card الگوی اختصاصی WAI-ARIA ندارد — نزدیک‌ترین آنالوگ الگوی Tooltip است. primitiveِ Base UI کارت را با فوکوس صفحه‌کلید روی تریگر باز می‌کند و با Escape می‌بندد. با این حال محتوا را مکمل کاربران بینا بدانید و تریگر را لینک واقعی نگه دارید تا محتوای کامل در مقصد در دسترس بماند.

تعاملات صفحه‌کلید:

کلیدعمل
Tab / Shift + Tabانتقال فوکوس به تریگر — فوکوس کارت را باز می‌کند، ترک کردن می‌بندد
Escapeبستن کارت
Enterدنبال کردن لینک تریگر

مرجع API

برای اطلاعات بیشتر، مستندات Base UI را ببینید.