کارت شناور
پیشنمایش شناور که با 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.jsonnpx shadcn@latest add https://neobrutalism.com/r/base/hover-card.jsonyarn dlx shadcn@latest add https://neobrutalism.com/r/base/hover-card.jsonbunx --bun shadcn@latest add https://neobrutalism.com/r/base/hover-card.json
وابستگیهای زیر را نصب کنید:
pnpm add @base-ui/reactnpm install @base-ui/reactyarn add @base-ui/reactbun add @base-ui/react
کد زیر را کپی کرده و در پروژهٔ خود جایگذاری کنید.
"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 را ببینید.