# Badge

紧凑的状态标签，用于标记、分类和行内强调。

**Install:** `nimbus-docs add badge`  
**Source:** `src/components/ui/badge/`  
**Canonical:** https://nimbus-docs.cn/components/badge/

## Agent payload (JSON)

```json
{
  "slug": "badge",
  "name": "Badge",
  "description": "Small status / category pill.",
  "tagline": "紧凑的状态标签，用于标记、分类和行内强调。",
  "install": "nimbus-docs add badge",
  "sourcePath": "src/components/ui/badge/",
  "canonicalUrl": "https://nimbus-docs.cn/components/badge/",
  "props": [
    {
      "name": "text",
      "type": "string",
      "required": true,
      "description": "徽章内渲染的标签文本。"
    },
    {
      "name": "variant",
      "type": "\"default\" | \"info\" | \"note\" | \"success\" | \"tip\" | \"warning\" | \"caution\" | \"danger\"",
      "defaultValue": "\"default\"",
      "required": false,
      "description": "传达意图的视觉样式。常用别名映射到标准配对：note→info、tip→success、caution→warning。"
    },
    {
      "name": "size",
      "type": "\"small\" | \"medium\" | \"large\"",
      "defaultValue": "\"small\"",
      "required": false,
      "description": "相对尺寸；影响内边距和字号。"
    }
  ],
  "registryDependencies": [
    "cn"
  ],
  "dependencies": []
}
```