# Banner

公告条 — 语义化类型、经过清理的 HTML 内容、可选的持久关闭功能。

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

## Agent payload (JSON)

```json
{
  "slug": "banner",
  "name": "Banner",
  "description": "Site-wide dismissible announcement bar.",
  "tagline": "公告条 — 语义化类型、经过清理的 HTML 内容、可选的持久关闭功能。",
  "install": "nimbus-docs add banner",
  "sourcePath": "src/components/ui/banner/",
  "canonicalUrl": "https://nimbus-docs.cn/components/banner/",
  "props": [
    {
      "name": "content",
      "type": "string",
      "required": true,
      "description": "经过清理后渲染为横幅主体的 HTML 字符串。"
    },
    {
      "name": "variant",
      "type": "\"note\" | \"tip\" | \"caution\" | \"danger\"",
      "defaultValue": "\"note\"",
      "required": false,
      "description": "传达意图的视觉样式。"
    },
    {
      "name": "dismissible",
      "type": "{ id: string; days?: number }",
      "required": false,
      "description": "显示关闭按钮；将关闭状态持久化到 localStorage 中，按给定 id 保存指定天数。"
    }
  ],
  "registryDependencies": [
    "cn"
  ],
  "dependencies": []
}
```