رفتن به محتوای اصلی

کامپوننت‌ها

کارت

ظرفی برای گروه‌بندی محتوای مرتبط، با سربرگ، بدنه و پانویس.

import { Card, CardHeader, CardTitle, CardDescription, CardBody, CardFooter } from "@kashi-ui/react";

پایه

پلن حرفه‌ای

برای تیم‌های در حال رشد

۴۹۰ هزار تومان در ماه، تا ۲۰ کاربر.
<Card>
<CardHeader>
  <CardTitle>پلن حرفه‌ای</CardTitle>
  <CardDescription>برای تیم‌های در حال رشد</CardDescription>
</CardHeader>
<CardBody>۴۹۰ هزار تومان در ماه، تا ۲۰ کاربر.</CardBody>
<CardFooter>
  <Button variant="tertiary">مقایسه</Button>
  <Button variant="primary">انتخاب پلن</Button>
</CardFooter>
</Card>

کارت قابل‌کلیک

کل سطح کارت قابل‌کلیک است، ولی فقط یک لینک با کلاس k-card__link دارد؛ کاربر کیبورد با یک Tab از آن عبور می‌کند.

<Card interactive>
<CardHeader>
  <Badge tone="brand">راهنما</Badge>
  <CardTitle>
    <a className="k-card__link" href="/docs/accessibility/">دسترس‌پذیری در کاشی</a>
  </CardTitle>
  <CardDescription>آنچه خودکار تضمین می‌شود و آنچه بر عهدهٔ شماست.</CardDescription>
</CardHeader>
</Card>

سبک‌ها، تصویر و منوی سربرگ

سبک برجسته

با تصویر و منوی سربرگ

سبک پرشده

بدون سایه، برای بخش‌های تودرتو

مناسب داخل صفحه‌هایی که خودشان کارت دارند.
<Card variant="elevated" padding="sm">
<CardMedia src="/cover.jpg" alt="" ratio="16 / 9" />
<CardHeader actions={<DropdownMenu trigger={…}>…</DropdownMenu>}>
  <CardTitle>سبک برجسته</CardTitle>
  <CardDescription>با تصویر و منوی سربرگ</CardDescription>
</CardHeader>
</Card>

<Card variant="filled">…</Card>
نامنوعپیش‌فرضتوضیح
variant"outlined" | "elevated" | "filled""outlined"سبک (Card)
padding"none" | "sm" | "md" | "lg""md"فاصلهٔ داخلی همهٔ بخش‌ها (Card)
actionsReactNode—دکمه یا منو در انتهای سربرگ (CardHeader)
ratiostring"16 / 9"نسبت ابعاد تصویر (CardMedia)

ویژگی‌ها

نامنوعپیش‌فرضتوضیح
asElementType"article"عنصر HTML؛ برای کارت‌های غیرمستقل div یا section
flatbooleanfalseبدون سایه
interactivebooleanfalseحالت hover و فوکوس برای کارت قابل‌کلیک

CardTitle پیش‌فرض h3 است. با as سطح عنوان را با ساختار صفحه هماهنگ کنید؛ برای مثال <CardTitle as="h2">.

متغیرهای CSS

متغیرپیش‌فرضکاربرد
--k-card-padding1.5rem × densityفاصلهٔ داخلی بخش‌ها
--k-card-radiusvar(--k-radius-xl)گردی گوشه‌ها
--k-card-bgvar(--k-bg-elevated)پس‌زمینه
--k-card-bordervar(--k-border-secondary)رنگ حاشیه
--k-card-shadowvar(--k-shadow-xs)سایه

دسترس‌پذیری

  • از کارت‌هایی که کل آن‌ها یک لینک بزرگ است (<a> دور همهٔ محتوا) پرهیز کنید؛ صفحه‌خوان همهٔ متن را به‌عنوان نام لینک می‌خواند.
  • در کارت قابل‌کلیک، دکمه‌های داخلی دیگر را بالای لایهٔ لینک (position: relative; z-index: 1) قرار دهید.