---
title: 徽章
description: 用于状态、类别和元数据的内联标签，提供 11 种颜色、4 种尺寸、图标、胶囊/圆角形状和描边。
---

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

使用 `<Badge>` 组件为内容添加状态指示器、类别标签或版本标记。徽章以紧凑的内联元素呈现，因此可以嵌入连续文本或堆叠在布局中。

## 基础徽章

带有默认样式的简单徽章：

<Badge>默认</Badge>

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

## 颜色

徽章提供 11 种颜色变体，用于传达不同含义：

<div className="flex flex-wrap gap-2 my-4">
  <Badge color="gray">灰色</Badge>
  <Badge color="blue">蓝色</Badge>
  <Badge color="green">绿色</Badge>
  <Badge color="yellow">黄色</Badge>
  <Badge color="orange">橙色</Badge>
  <Badge color="red">红色</Badge>
  <Badge color="purple">紫色</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>
```

### 表面颜色

用于适应页面背景的徽章：

<div className="flex flex-wrap gap-2 my-4">
  <Badge color="white">白色</Badge>
  <Badge color="surface">表面色</Badge>
</div>

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

### 危险颜色

用于警告或错误状态：

<div className="flex flex-wrap gap-2 my-4">
  <Badge color="white-destructive">白色危险</Badge>
  <Badge color="surface-destructive">表面危险</Badge>
</div>

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

## 带图标

添加图标，让徽章的含义更加明确：

<div className="flex flex-wrap gap-2 my-4">
  <Badge icon="circle-check" color="green">已验证</Badge>
  <Badge icon="star" color="yellow">精选</Badge>
  <Badge icon="bolt" color="purple">新增</Badge>
  <Badge icon="clock" color="blue">待处理</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>
```

### 图标类型

使用 `iconType` 指定不同的图标样式：

<div className="flex flex-wrap gap-2 my-4">
  <Badge icon="star" iconType="solid" color="yellow">实心</Badge>
  <Badge icon="star" iconType="regular" color="yellow">常规</Badge>
  <Badge icon="star" iconType="duotone" color="yellow">双色</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>
```

## 尺寸

提供四种尺寸，可适应不同场景：

<div className="flex flex-wrap items-center gap-2 my-4">
  <Badge size="xs" color="blue">超小</Badge>
  <Badge size="sm" color="blue">小</Badge>
  <Badge size="md" color="blue">中</Badge>
  <Badge size="lg" color="blue">大</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>
```

## 形状

选择圆角或胶囊形状：

<div className="flex flex-wrap gap-2 my-4">
  <Badge shape="rounded" color="purple">圆角</Badge>
  <Badge shape="pill" color="purple">胶囊</Badge>
</div>

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

## 描边变体

使用描边徽章实现更轻盈的视觉效果：

<div className="flex flex-wrap gap-2 my-4">
  <Badge stroke color="blue">蓝色描边</Badge>
  <Badge stroke color="green">绿色描边</Badge>
  <Badge stroke color="red">红色描边</Badge>
  <Badge stroke color="purple">紫色描边</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>
```

## 禁用状态

降低不活跃徽章的不透明度：

<div className="flex flex-wrap gap-2 my-4">
  <Badge disabled color="gray">不活跃</Badge>
  <Badge disabled color="blue">已禁用</Badge>
</div>

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

## 内联用法

徽章可以与文本内联使用。此功能需要订阅<Badge color="orange" size="sm">高级版</Badge>。你也可以将项目标记为<Badge color="green" size="sm">新增</Badge>或<Badge color="red" size="sm">已弃用</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>.
```

## 属性

<ParamField name="color" type="string" default="gray">
  颜色变体：`gray`、`blue`、`green`、`yellow`、`orange`、`red`、`purple`、`white`、`surface`、`white-destructive`、`surface-destructive`。
</ParamField>

<ParamField name="size" type="string" default="md">
  徽章尺寸：`xs`、`sm`、`md`、`lg`。
</ParamField>

<ParamField name="shape" type="string" default="rounded">
  徽章形状：`rounded`、`pill`。
</ParamField>

<ParamField name="icon" type="string">
  Font Awesome 图标名称。
</ParamField>

<ParamField name="iconType" type="string">
  图标样式：`regular`、`solid`、`light`、`thin`、`sharp-solid`、`duotone`、`brands`。
</ParamField>

<ParamField name="stroke" type="boolean" default="false">
  显示为带透明背景的描边徽章。
</ParamField>

<ParamField name="disabled" type="boolean" default="false">
  降低不透明度以表示不活跃状态。
</ParamField>

<ParamField name="className" type="string">
  用于自定义样式的其他 CSS 类。
</ParamField>

## 接下来做什么？

<Columns cols={2}>
  <Card title="组件概览" icon="puzzle-piece" href="/cn/components/overview">
    浏览所有可用组件
  </Card>
  <Card title="MDX 基础" icon="file-code" href="/cn/content/mdx-basics">
    了解如何在 MDX 中使用组件
  </Card>
</Columns>