---
title: Distintivo
description: Use etiquetas inline para status, categorias e metadados, com 11 variações de cor, 4 tamanhos, ícones, formatos pílula/arredondado e contornos.
---

> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.

Use o componente `<Badge>` para marcar conteúdo com indicadores de status, rótulos de categoria ou marcadores de versão. Os badges são renderizados como elementos inline compactos, podendo ser inseridos em textos corridos ou organizados em um layout.

## Distintivo básico

Um badge simples com o estilo padrão:

<Badge>Padrão</Badge>

```mdx
<Badge>Default</Badge>
```

## Cores

Os badges têm 11 variações de cor para transmitir diferentes significados:

<div className="flex flex-wrap gap-2 my-4">
  <Badge color="gray">Cinza</Badge>
  <Badge color="blue">Azul</Badge>
  <Badge color="green">Verde</Badge>
  <Badge color="yellow">Amarelo</Badge>
  <Badge color="orange">Laranja</Badge>
  <Badge color="red">Vermelho</Badge>
  <Badge color="purple">Roxo</Badge>
</div>

```mdx
<Badge color="gray">Gray</Badge>
<Badge color="blue">Blue</Badge>
<Badge color="green">Green</Badge>
<Badge color="yellow">Yellow</Badge>
<Badge color="orange">Orange</Badge>
<Badge color="red">Red</Badge>
<Badge color="purple">Purple</Badge>
```

### Cores de superfície

Para badges que se adaptam ao plano de fundo da página:

<div className="flex flex-wrap gap-2 my-4">
  <Badge color="white">Branco</Badge>
  <Badge color="surface">Superfície</Badge>
</div>

```mdx
<Badge color="white">White</Badge>
<Badge color="surface">Surface</Badge>
```

### Cores destrutivas

Para estados de aviso ou erro:

<div className="flex flex-wrap gap-2 my-4">
  <Badge color="white-destructive">Branco destrutivo</Badge>
  <Badge color="surface-destructive">Superfície destrutiva</Badge>
</div>

```mdx
<Badge color="white-destructive">White Destructive</Badge>
<Badge color="surface-destructive">Surface Destructive</Badge>
```

## Com ícones

Adicione ícones para tornar os badges mais descritivos:

<div className="flex flex-wrap gap-2 my-4">
  <Badge icon="circle-check" color="green">Verificado</Badge>
  <Badge icon="star" color="yellow">Em destaque</Badge>
  <Badge icon="bolt" color="purple">Novo</Badge>
  <Badge icon="clock" color="blue">Pendente</Badge>
</div>

```mdx
<Badge icon="circle-check" color="green">Verified</Badge>
<Badge icon="star" color="yellow">Featured</Badge>
<Badge icon="bolt" color="purple">New</Badge>
<Badge icon="clock" color="blue">Pending</Badge>
```

### Tipos de ícone

Especifique um estilo de ícone diferente usando `iconType`:

<div className="flex flex-wrap gap-2 my-4">
  <Badge icon="star" iconType="solid" color="yellow">Sólido</Badge>
  <Badge icon="star" iconType="regular" color="yellow">Regular</Badge>
  <Badge icon="star" iconType="duotone" color="yellow">Duotone</Badge>
  <Badge icon="github" iconType="brands" color="gray">GitHub</Badge>
</div>

```mdx
<Badge icon="star" iconType="solid" color="yellow">Solid</Badge>
<Badge icon="star" iconType="regular" color="yellow">Regular</Badge>
<Badge icon="star" iconType="duotone" color="yellow">Duotone</Badge>
<Badge icon="github" iconType="brands" color="gray">GitHub</Badge>
```

## Tamanhos

Quatro tamanhos estão disponíveis para diferentes contextos:

<div className="flex flex-wrap items-center gap-2 my-4">
  <Badge size="xs" color="blue">Extra pequeno</Badge>
  <Badge size="sm" color="blue">Pequeno</Badge>
  <Badge size="md" color="blue">Médio</Badge>
  <Badge size="lg" color="blue">Grande</Badge>
</div>

```mdx
<Badge size="xs" color="blue">Extra Small</Badge>
<Badge size="sm" color="blue">Small</Badge>
<Badge size="md" color="blue">Medium</Badge>
<Badge size="lg" color="blue">Large</Badge>
```

## Formatos

Escolha entre cantos arredondados ou formato de pílula:

<div className="flex flex-wrap gap-2 my-4">
  <Badge shape="rounded" color="purple">Arredondado</Badge>
  <Badge shape="pill" color="purple">Pílula</Badge>
</div>

```mdx
<Badge shape="rounded" color="purple">Rounded</Badge>
<Badge shape="pill" color="purple">Pill</Badge>
```

## Variante com contorno

Use badges contornados para obter um peso visual mais leve:

<div className="flex flex-wrap gap-2 my-4">
  <Badge stroke color="blue">Azul contornado</Badge>
  <Badge stroke color="green">Verde contornado</Badge>
  <Badge stroke color="red">Vermelho contornado</Badge>
  <Badge stroke color="purple">Roxo contornado</Badge>
</div>

```mdx
<Badge stroke color="blue">Outlined Blue</Badge>
<Badge stroke color="green">Outlined Green</Badge>
<Badge stroke color="red">Outlined Red</Badge>
<Badge stroke color="purple">Outlined Purple</Badge>
```

## Estado desativado

Reduza a opacidade para badges inativos:

<div className="flex flex-wrap gap-2 my-4">
  <Badge disabled color="gray">Inativo</Badge>
  <Badge disabled color="blue">Desativado</Badge>
</div>

```mdx
<Badge disabled color="gray">Inactive</Badge>
<Badge disabled color="blue">Disabled</Badge>
```

## Uso inline

Os badges funcionam inline com o texto. Este recurso requer uma assinatura <Badge color="orange" size="sm">Premium</Badge>. Você também pode marcar itens como <Badge color="green" size="sm">Novo</Badge> ou <Badge color="red" size="sm">Obsoleto</Badge>.

```mdx
This feature requires a <Badge color="orange" size="sm">Premium</Badge> subscription.
You can also mark items as <Badge color="green" size="sm">New</Badge> or
<Badge color="red" size="sm">Deprecated</Badge>.
```

## Propriedades

<ParamField name="color" type="string" default="gray">
  Variante de cor: `gray`, `blue`, `green`, `yellow`, `orange`, `red`, `purple`, `white`, `surface`, `white-destructive`, `surface-destructive`.
</ParamField>

<ParamField name="size" type="string" default="md">
  Tamanho do badge: `xs`, `sm`, `md`, `lg`.
</ParamField>

<ParamField name="shape" type="string" default="rounded">
  Formato do badge: `rounded`, `pill`.
</ParamField>

<ParamField name="icon" type="string">
  Nome do ícone do Font Awesome.
</ParamField>

<ParamField name="iconType" type="string">
  Estilo do ícone: `regular`, `solid`, `light`, `thin`, `sharp-solid`, `duotone`, `brands`.
</ParamField>

<ParamField name="stroke" type="boolean" default="false">
  Exibe um badge contornado com fundo transparente.
</ParamField>

<ParamField name="disabled" type="boolean" default="false">
  Reduz a opacidade para indicar um estado inativo.
</ParamField>

<ParamField name="className" type="string">
  Classes CSS adicionais para personalização do estilo.
</ParamField>

## Próximos passos

<Columns cols={2}>
  <Card title="Visão geral dos componentes" icon="puzzle-piece" href="/pt/components/overview">
    Consulte todos os componentes disponíveis
  </Card>
  <Card title="Fundamentos do MDX" icon="file-code" href="/pt/content/mdx-basics">
    Aprenda a usar componentes no MDX
  </Card>
</Columns>