پرش به محتوا

نشان

یک برچسب کوچک برای وضعیت‌ها، شمارش‌ها و برچسب‌ها روی کارت‌ها، جداول و آیتم‌های ناوبری — با جلوه‌ی نئوبروتالیستی حاشیه‌ها و سایه‌ها.

import { Badge } from "@/components/ui/badge"

export function BadgeDemo() {

بج یک برچسب فشردهٔ درون‌خطی است — یک <span> ساده بدون primitive زیرین، با دستور پخت نئوبروتالیستی: حاشیه‌های ضخیم، سایه‌های سخت و تایپوگرافی پررنگ. propِ render (از طریق useRender در Base UI) می‌گذارد هر عنصری — لینک، دکمه — استایل بج را بپوشد.

برای این موارد از آن استفاده کنید:

  • وضعیت‌ها — «Active»، «Draft»، «Failed» روی ردیف جدول و کارت؛ destructive برای خطاها.
  • شمارنده‌ها — پیام‌های نخوانده، اقلام سبد، جمع اعلان‌ها کنار برچسب‌های nav.
  • تگ و metadata — دسته‌ها روی کارت وبلاگ، سطح پلن، برچسب نسخه در docs.

نصب

pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/badge.json
npx shadcn@latest add https://neobrutalism.com/r/base/badge.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/badge.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/badge.json

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

components/ui/badge.tsx
import * as React from "react"
import { cva, type VariantProps } from "class-variance-authority"
import { Slot } from "radix-ui"

import { cn } from "@/lib/utils"

const badgeVariants = cva(
  "group/badge inline-flex h-5 w-fit shrink-0 items-center justify-center gap-1 overflow-hidden rounded border-2 px-2 py-0.5 text-xs font-head font-medium whitespace-nowrap shadow-sm transition-all focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 aria-invalid:border-destructive [&>svg]:pointer-events-none [&>svg]:size-3!",
  {
    variants: {
      variant: {
        default: "bg-primary text-primary-foreground [a]:hover:bg-primary/80",
        secondary:
          "bg-secondary text-secondary-foreground [a]:hover:bg-secondary/80",
        destructive:
          "bg-destructive text-destructive-foreground [a]:hover:bg-destructive/90",
        outline:
          "bg-transparent text-foreground [a]:hover:bg-muted [a]:hover:text-muted-foreground",
        ghost:
          "border-transparent bg-transparent shadow-none hover:bg-muted hover:text-muted-foreground dark:hover:bg-muted/50",
        link: "border-transparent bg-transparent shadow-none text-primary underline-offset-4 hover:underline",
      },
    },
    defaultVariants: {
      variant: "default",
    },
  }
)

function Badge({
  className,
  variant = "default",
  asChild = false,
  ...props
}: React.ComponentProps<"span"> &
  VariantProps<typeof badgeVariants> & { asChild?: boolean }) {
  const Comp = asChild ? Slot.Root : "span"

  return (
    <Comp
      data-slot="badge"
      data-variant={variant}
      className={cn(badgeVariants({ variant }), className)}
      {...props}
    />
  )
}

export { Badge, badgeVariants }

مسیرهای import را متناسب با ساختار پروژهٔ خود به‌روزرسانی کنید.

استفاده

import { Badge } from "@/components/ui/badge"
<Badge variant="default | outline | secondary | destructive">Badge</Badge>

نمونه‌ها

انواع

از پراپ variant برای تغییر نوع badge استفاده کنید.

import { Badge } from "@/components/ui/badge"

export function BadgeVariants() {

با آیکون

می‌توانید یک آیکون داخل badge رندر کنید. از data-icon="inline-start" برای رندر آیکون در سمت چپ و از data-icon="inline-end" برای رندر آیکون در سمت راست استفاده کنید.

import { BadgeCheck, BookmarkIcon } from "lucide-react"

import { Badge } from "@/components/ui/badge"

با اسپینر

می‌توانید یک اسپینر داخل badge رندر کنید. فراموش نکنید که پراپ data-icon="inline-start" یا data-icon="inline-end" را به اسپینر اضافه کنید.

import { Badge } from "@/components/ui/badge"
import { Spinner } from "@/components/ui/spinner"

پیوند

از پراپ render برای رندر یک پیوند به شکل badge استفاده کنید.

import { ArrowUpRightIcon } from "lucide-react"

import { Badge } from "@/components/ui/badge"

رنگ‌های سفارشی

می‌توانید رنگ‌های یک badge را با افزودن کلاس‌های سفارشی مانند bg-chart-2 text-primary-foreground به کامپوننت Badge سفارشی کنید.

import { Badge } from "@/components/ui/badge"

export function BadgeCustomColors() {

RTL

برای فعال‌سازی پشتیبانی RTL در Neobrutalism، راهنمای پیکربندی RTL را ببینید.

"use client"

import * as React from "react"

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

بج یک <span> ساده رندر می‌کند — صفحه‌خوان فقط متنش را می‌گیرد، پس معنا را فقط به رنگ نسپارید: variant="destructive" همان‌طور اعلام می‌شود که default؛ متن باید بگوید «Failed». شمارنده‌های لخت نیاز به زمینه دارند — aria-label یا متن پنهان بصری اضافه کنید تا «3» به‌صورت «3 اعلان نخوانده» خوانده شود. وقتی از طریق propِ render به‌صورت لینک رندر شود، anchor معمولی است و semantics لینک اعمال می‌شود.

مرجع API

Badge

کامپوننت Badge یک badge یا کامپوننتی که شبیه badge به نظر می‌رسد نمایش می‌دهد.

PropTypeDefault
variant"default" | "secondary" | "destructive" | "outline" | "ghost" | "link""default"
classNamestring-