کارت
یک کادر حاشیهدار برای داشبوردها، سطوح قیمتگذاری و شبکههای محصول — سربرگ، محتوا و پاورقی با جلوهی سایهٔ سخت نئوبروتالیست.
import { Button } from "@/components/ui/button"
import {
Card,کارت محتوای مرتبط را در یک جعبهٔ خودکفا با اسلاتهای اختیاری header، content و footer گروهبندی میکند. primitive زیرین ندارد — markup ساده با دستور پخت نئوبروتالیستی: حاشیهٔ ضخیم، سایهٔ offset سخت و عنوان با فونت heading.
برای این موارد از آن استفاده کنید:
- پنل داشبورد — کاشی آمار، نمودار و فید فعالیت در یک شبکه.
- سطح قیمتگذاری — نام و قیمت پلن در header، ویژگیها در بدنه، دکمهٔ خرید در footer.
- فرمهای مستقل — جعبههای ورود، ثبتنام و تنظیمات که مرز بصری میخواهند.
نصب#
pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/card.jsonnpx shadcn@latest add https://neobrutalism.com/r/base/card.jsonyarn dlx shadcn@latest add https://neobrutalism.com/r/base/card.jsonbunx --bun shadcn@latest add https://neobrutalism.com/r/base/card.json
کد زیر را کپی کنید و در پروژهٔ خود بچسبانید.
import * as React from "react"
import { cn } from "@/lib/utils"
function Card({
className,
size = "default",
...props
}: React.ComponentProps<"div"> & { size?: "default" | "sm" }) {
return (
<div
data-slot="card"
data-size={size}
className={cn(
"group/card flex flex-col gap-(--card-spacing) overflow-hidden rounded border-2 bg-card py-(--card-spacing) text-sm text-card-foreground shadow-md [--card-spacing:--spacing(4)] has-data-[slot=card-footer]:pb-0 has-[>img:first-child]:pt-0 data-[size=sm]:[--card-spacing:--spacing(3)] data-[size=sm]:has-data-[slot=card-footer]:pb-0 *:[img:first-child]:rounded-t-xl *:[img:last-child]:rounded-b-xl",
className
)}
{...props}
/>
)
}
function CardHeader({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
data-slot="card-header"
className={cn(
"group/card-header @container/card-header grid auto-rows-min items-start gap-1 rounded-t-xl px-(--card-spacing) has-data-[slot=card-action]:grid-cols-[1fr_auto] has-data-[slot=card-description]:grid-rows-[auto_auto] [.border-b]:pb-(--card-spacing)",
className
)}
{...props}
/>
)
}
function CardTitle({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
data-slot="card-title"
className={cn(
"cn-font-heading text-base leading-snug font-medium group-data-[size=sm]/card:text-sm",
className
)}
{...props}
/>
)
}
function CardDescription({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
data-slot="card-description"
className={cn("text-sm text-muted-foreground", className)}
{...props}
/>
)
}
function CardAction({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
data-slot="card-action"
className={cn(
"col-start-2 row-span-2 row-start-1 self-start justify-self-end",
className
)}
{...props}
/>
)
}
function CardContent({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
data-slot="card-content"
className={cn("px-(--card-spacing)", className)}
{...props}
/>
)
}
function CardFooter({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
data-slot="card-footer"
className={cn(
"flex items-center rounded-b-xl border-t-2 bg-muted/50 p-(--card-spacing)",
className
)}
{...props}
/>
)
}
export {
Card,
CardHeader,
CardFooter,
CardTitle,
CardAction,
CardDescription,
CardContent,
}
مسیرهای import را متناسب با ساختار پروژهٔ خود بهروزرسانی کنید.
استفاده#
import {
Card,
CardAction,
CardContent,
CardDescription,
CardFooter,
CardHeader,
CardTitle,
} from "@/components/ui/card"<Card>
<CardHeader>
<CardTitle>Card Title</CardTitle>
<CardDescription>Card Description</CardDescription>
<CardAction>Card Action</CardAction>
</CardHeader>
<CardContent>
<p>Card Content</p>
</CardContent>
<CardFooter>
<p>Card Footer</p>
</CardFooter>
</Card>ترکیب#
برای ساخت Card از ترکیب زیر استفاده کنید:
Card
├── CardHeader
│ ├── CardTitle
│ ├── CardDescription
│ └── CardAction
├── CardContent
└── CardFooterنمونهها#
اندازه#
از پراپ size="sm" برای تنظیم اندازهٔ card روی کوچک استفاده کنید. نوع اندازهٔ کوچک از فاصلهگذاری کمتری استفاده میکند.
import { ChevronRightIcon } from "lucide-react"
import { Button } from "@/components/ui/button"فاصلهگذاری#
علاوه بر پراپ size، میتوانید از متغیر CSS --card-spacing برای کنترل فاصلهٔ بین بخشها و تورفتگی اجزای card استفاده کنید.
"use client"
import * as React from "react"از حاشیههای منفی با -mx-(--card-spacing) استفاده کنید تا محتوا از لبه تا لبه امتداد یابد و در عین حال با تورفتگی card همتراز بماند. وقتی محتوای لبهتالبه بالای یک پابرگ قرار میگیرد، از -mb-(--card-spacing) روی CardContent استفاده کنید تا فاصلهٔ بین بخشها حذف شود.
import { Button } from "@/components/ui/button"
import {
Card,تصویر#
یک تصویر پیش از سربرگ card اضافه کنید تا یک card با تصویر بسازید.
import { Badge } from "@/components/ui/badge"
import { Button } from "@/components/ui/button"
import {RTL#
برای فعالسازی پشتیبانی RTL در Neobrutalism، راهنمای پیکربندی RTL را ببینید.
"use client"
import * as React from "react"دسترسیپذیری#
کارت کاملاً presentational است — هر بخش یک <div> ساده بدون role ضمنی رندر میکند، پس چیزی به درخت دسترسیپذیری اضافه نمیکند. CardTitle عنصر heading نیست: وقتی عنوان باید در outline سند باشد، یک <h2>–<h4> واقعی داخلش بگذارید. برای کارتهای قابلکلیک، لینک یا دکمه را داخل کارت بگذارید و hit area را روی سطح بکشید — هرگز onClick را به خود <div> کارت وصل نکنید.
مرجع API#
Card#
کامپوننت Card کانتینر ریشه برای محتوای card است.
| Prop | Type | Default |
|---|---|---|
size | "default" | "sm" | "default" |
className | string | - |
CardHeader#
کامپوننت CardHeader برای یک عنوان، توضیح و یک کنش اختیاری استفاده میشود.
| Prop | Type | Default |
|---|---|---|
className | string | - |
CardTitle#
کامپوننت CardTitle برای عنوان card استفاده میشود.
| Prop | Type | Default |
|---|---|---|
className | string | - |
CardDescription#
کامپوننت CardDescription برای متن کمکی زیر عنوان استفاده میشود.
| Prop | Type | Default |
|---|---|---|
className | string | - |
CardAction#
کامپوننت CardAction محتوا را در بالا-راست سربرگ قرار میدهد (برای مثال، یک دکمه یا یک badge).
| Prop | Type | Default |
|---|---|---|
className | string | - |
CardContent#
کامپوننت CardContent برای بدنهٔ اصلی card استفاده میشود.
| Prop | Type | Default |
|---|---|---|
className | string | - |
CardFooter#
کامپوننت CardFooter برای کنشها و محتوای ثانویه در پایین card استفاده میشود.
| Prop | Type | Default |
|---|---|---|
className | string | - |
تاریخچهٔ تغییرات#
متغیر فاصلهگذاری#
اگر از نسخهٔ قبلی کامپوننت Card ارتقا میدهید، باید تغییرات زیر را برای استفاده از متغیر --card-spacing اعمال کنید:
کلاسهای فاصلهگذاری ریشهٔ Card را بهروزرسانی کنید.
gap و padding عمودی سختکدشده را با --card-spacing جایگزین کنید و مقادیر اندازهٔ پیشفرض و کوچک را روی ریشه تنظیم کنید:
className={cn(
- "group/card flex flex-col gap-4 overflow-hidden rounded-xl bg-card py-4 text-sm text-card-foreground ring-1 ring-foreground/10 has-data-[slot=card-footer]:pb-0 has-[>img:first-child]:pt-0 data-[size=sm]:gap-3 data-[size=sm]:py-3 data-[size=sm]:has-data-[slot=card-footer]:pb-0 *:[img:first-child]:rounded-t-xl *:[img:last-child]:rounded-b-xl",
+ "group/card flex flex-col gap-(--card-spacing) overflow-hidden rounded-xl bg-card py-(--card-spacing) text-sm text-card-foreground ring-1 ring-foreground/10 [--card-spacing:--spacing(4)] has-data-[slot=card-footer]:pb-0 has-[>img:first-child]:pt-0 data-[size=sm]:[--card-spacing:--spacing(3)] data-[size=sm]:has-data-[slot=card-footer]:pb-0 *:[img:first-child]:rounded-t-xl *:[img:last-child]:rounded-b-xl",
className
)}کلاسهای فاصلهگذاری CardHeader را بهروزرسانی کنید.
padding افقی و فاصلهگذاری حاشیه را با متغیر مشترک جایگزین کنید:
className={cn(
- "group/card-header @container/card-header grid auto-rows-min items-start gap-1 rounded-t-xl px-4 group-data-[size=sm]/card:px-3 has-data-[slot=card-action]:grid-cols-[1fr_auto] has-data-[slot=card-description]:grid-rows-[auto_auto] [.border-b]:pb-4 group-data-[size=sm]/card:[.border-b]:pb-3",
+ "group/card-header @container/card-header grid auto-rows-min items-start gap-1 rounded-t-xl px-(--card-spacing) has-data-[slot=card-action]:grid-cols-[1fr_auto] has-data-[slot=card-description]:grid-rows-[auto_auto] [.border-b]:pb-(--card-spacing)",
className
)}کلاسهای فاصلهگذاری CardContent و CardFooter را بهروزرسانی کنید.
از --card-spacing برای تورفتگی محتوا و padding پابرگ استفاده کنید:
function CardContent({ className, ...props }: React.ComponentProps<"div">) {
return (
<div
data-slot="card-content"
- className={cn("px-4 group-data-[size=sm]/card:px-3", className)}
+ className={cn("px-(--card-spacing)", className)}
{...props}
/>
)
} className={cn(
- "flex items-center rounded-b-xl border-t bg-muted/50 p-4 group-data-[size=sm]/card:p-3",
+ "flex items-center rounded-b-xl border-t bg-muted/50 p-(--card-spacing)",
className
)}پس از اعمال این تغییرات، میتوانید فاصلهگذاری card را با تنظیم --card-spacing روی Card با یک کلاس ویژگی دلخواه سفارشی کنید:
function Example() {
return <Card className="[--card-spacing:--spacing(6)]">...</Card>
}