پرش به محتوا

کارت

یک کادر حاشیه‌دار برای داشبوردها، سطوح قیمت‌گذاری و شبکه‌های محصول — سربرگ، محتوا و پاورقی با جلوه‌ی سایهٔ سخت نئوبروتالیست.

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.json
npx shadcn@latest add https://neobrutalism.com/r/base/card.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/card.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/card.json

کد زیر را کپی کنید و در پروژهٔ خود بچسبانید.

components/ui/card.tsx
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 است.

PropTypeDefault
size"default" | "sm""default"
classNamestring-

CardHeader

کامپوننت CardHeader برای یک عنوان، توضیح و یک کنش اختیاری استفاده می‌شود.

PropTypeDefault
classNamestring-

CardTitle

کامپوننت CardTitle برای عنوان card استفاده می‌شود.

PropTypeDefault
classNamestring-

CardDescription

کامپوننت CardDescription برای متن کمکی زیر عنوان استفاده می‌شود.

PropTypeDefault
classNamestring-

CardAction

کامپوننت CardAction محتوا را در بالا-راست سربرگ قرار می‌دهد (برای مثال، یک دکمه یا یک badge).

PropTypeDefault
classNamestring-

CardContent

کامپوننت CardContent برای بدنهٔ اصلی card استفاده می‌شود.

PropTypeDefault
classNamestring-

CardFooter

کامپوننت CardFooter برای کنش‌ها و محتوای ثانویه در پایین card استفاده می‌شود.

PropTypeDefault
classNamestring-

تاریخچهٔ تغییرات

متغیر فاصله‌گذاری

اگر از نسخهٔ قبلی کامپوننت 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>
}