پرتوپرتو

نشان (Badge)

کامپوننت نمایش برچسب‌ها و وضعیت‌ها

معرفی

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

استفاده

پیش‌فرض
فرعی
هشدار
حاشیه‌دار
import { Badge } from '@parto/ui';

<div className="flex flex-wrap gap-2">
  <Badge>پیش‌فرض</Badge>
  <Badge variant="secondary">فرعی</Badge>
  <Badge variant="success">موفقیت</Badge>
  <Badge variant="warning">هشدار</Badge>
  <Badge variant="destructive">خطا</Badge>
  <Badge variant="brand">برند</Badge>
  <Badge variant="outline">حاشیه‌دار</Badge>
</div>

انواع

پیش‌فرض

<Badge>پیش‌فرض</Badge>

فرعی (Secondary)

<Badge variant="secondary">فرعی</Badge>

موفقیت (Success)

<Badge variant="success">موفقیت</Badge>

هشدار (Warning)

<Badge variant="warning">هشدار</Badge>

خطا (Destructive)

<Badge variant="destructive">خطا</Badge>

برند (Brand)

<Badge variant="brand">برند</Badge>

حاشیه‌دار (Outline)

<Badge variant="outline">حاشیه‌دار</Badge>

استفاده در کنار متن

<div className="flex items-center gap-2">
  <span>وضعیت:</span>
  <Badge>فعال</Badge>
</div>

با آیکون

import { Icons } from '@parto/ui';

<Badge>
  <Icons.check className="w-3 h-3 ms-1" />
  تایید شده
</Badge>

نمایش تعداد

<div className="relative inline-block">
  <Icons.bell className="w-6 h-6" />
  <Badge className="absolute -top-1 -end-1 px-1 min-w-[18px] h-[18px] flex items-center justify-center">
    5
  </Badge>
</div>

Props

PropTypeDefaultDescription
variant'default' | 'secondary' | 'success' | 'warning' | 'destructive' | 'brand' | 'outline''default'نوع ظاهری نشان
classNamestring-کلاس‌های CSS اضافی

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

  • برای محتوای معنادار از تگ مناسب استفاده کنید
  • برای اعداد، از aria-label توضیحی استفاده کنید
  • کنتراست رنگی مناسب برای خوانایی

ملاحظات RTL

  • متن به‌صورت خودکار راست‌چین می‌شود
  • آیکون‌ها در سمت راست متن قرار می‌گیرند
  • موقعیت‌های absolute با start/end تنظیم می‌شوند