Badge

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

export function BadgeDemo() {

Der Badge ist ein kompaktes Inline-Label – ein schlichtes <span> ohne Primitive darunter, gestaltet nach dem neobrutalistischen Rezept: dicke Rahmen, harte Schatten und kräftige Typografie. Über die render-Prop (via useRender von Base UI) kann jedes Element – ein Link, ein Button – die Badge-Styles tragen.

Die richtige Wahl für:

• Status – „Aktiv“, „Entwurf“, „Fehlgeschlagen“ auf Tabellenzeilen und Karten; destructive für Fehler.
• Zähler – ungelesene Nachrichten, Artikel im Warenkorb, Benachrichtigungssummen neben Navigationseinträgen.
• Tags und Metadaten – Kategorien auf Blog-Karten, Tarifstufen, Versionslabels in der Doku.

Installation#

pnpmnpmyarnbun
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
Kopieren

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 }

Verwendung#

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

Kopieren<Badge variant="default | outline | secondary | destructive">Badge</Badge>

Beispiele#

Varianten#

Verwende die Prop variant, um die Variante des Badges zu ändern.

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

export function BadgeVariants() {

Mit Icon#

Du kannst ein Icon innerhalb des Badges rendern. Verwende data-icon="inline-start", um das Icon links zu rendern, und data-icon="inline-end", um das Icon rechts zu rendern.

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

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

Mit Spinner#

Du kannst einen Spinner innerhalb des Badges rendern. Denk daran, dem Spinner die Prop data-icon="inline-start" oder data-icon="inline-end" hinzuzufügen.

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

Link#

Verwende die Prop render, um einen Link als Badge zu rendern.

import { ArrowUpRightIcon } from "lucide-react"

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

Benutzerdefinierte Farben#

Du kannst die Farben eines Badges anpassen, indem du benutzerdefinierte Klassen wie bg-chart-2 text-primary-foreground zur Badge-Komponente hinzufügst.

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

export function BadgeCustomColors() {

RTL#

Um die RTL-Unterstützung in Neobrutalism zu aktivieren, siehe die RTL-Konfigurationsanleitung.

"use client"

import * as React from "react"

Barrierefreiheit#

Der Badge rendert ein schlichtes <span> – Screenreader bekommen seinen Text und sonst nichts. Lass die Bedeutung also nicht allein an der Farbe hängen: variant="destructive" wird genauso angekündigt wie default, der Text selbst muss „Fehlgeschlagen“ sagen. Nackte Zahlen brauchen Kontext – ergänze ein aria-label oder visuell versteckten Text, damit „3“ als „3 ungelesene Benachrichtigungen“ vorgelesen wird. Als Link über die render-Prop gerendert, ist er ein gewöhnlicher Anker, und es gilt die übliche Link-Semantik.

API-Referenz#

Badge#

Die Badge-Komponente zeigt ein Badge oder eine Komponente, die wie ein Badge aussieht.