Pular para o conteúdo

Distintivo

Um pequeno selo para status, contagens e tags em cartões, tabelas e itens de navegação — com aquele estilo neobrutalista de bordas e sombras.

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

export function BadgeDemo() {

O badge é um rótulo inline compacto — um <span> puro, sem primitivo por baixo, estilizado seguindo a receita neobrutalista: bordas grossas, sombras duras e tipografia em negrito. A prop render (via useRender do Base UI) permite que qualquer elemento — um link, um botão — vista os estilos do badge.

Use quando:

  • Status — “Ativo”, “Rascunho”, “Falhou” em linhas de tabela e cards; destructive para erros.
  • Contagens — mensagens não lidas, itens no carrinho, totais de notificações ao lado dos rótulos de navegação.
  • Tags e metadados — categorias em cards de blog, níveis de plano, rótulos de versão na documentação.

Instalação

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

Copie e cole o código a seguir no seu projeto.

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 }

Atualize os caminhos de importação para corresponder à estrutura do seu projeto.

Uso

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

Exemplos

Variantes

Use a prop variant para alterar a variante do badge.

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

export function BadgeVariants() {

Com ícone

Você pode exibir um ícone dentro do badge. Use data-icon="inline-start" para colocar o ícone à esquerda e data-icon="inline-end" para colocá-lo à direita.

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

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

Com spinner

Você pode exibir um spinner dentro do badge. Lembre-se de adicionar a prop data-icon="inline-start" ou data-icon="inline-end" ao spinner.

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

Use a prop render para exibir um link em forma de badge.

import { ArrowUpRightIcon } from "lucide-react"

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

Cores personalizadas

Você pode personalizar as cores de um badge adicionando classes personalizadas como bg-chart-2 text-primary-foreground ao componente Badge.

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

export function BadgeCustomColors() {

RTL

Para ativar o suporte a RTL no Neobrutalism, consulte o guia de configuração de RTL.

"use client"

import * as React from "react"

Acessibilidade

O badge renderiza um <span> puro — leitores de tela recebem o texto e nada mais, então não deixe a cor carregar sozinha o significado: variant="destructive" é anunciado igual ao default, é o texto que precisa dizer “Falhou”. Contagens soltas precisam de contexto — adicione um aria-label ou texto visualmente oculto para que “3” seja lido como “3 notificações não lidas”. Quando renderizado como link via a prop render, ele é uma âncora comum e valem as semânticas usuais de link.

Referência da API

Badge

O componente Badge exibe um badge ou um componente que parece um badge.

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