# Sidebar

递归导航树 — 可折叠分组、持久化展开状态、滚动位置恢复。

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

## Agent payload (JSON)

```json
{
  "slug": "sidebar",
  "name": "Sidebar",
  "description": "Docs sidebar with nested groups and active-link tracking.",
  "tagline": "递归导航树 — 可折叠分组、持久化展开状态、滚动位置恢复。",
  "install": "nimbus-docs add sidebar",
  "sourcePath": "src/components/ui/sidebar/",
  "canonicalUrl": "https://nimbus-docs.cn/components/sidebar/",
  "props": [
    {
      "name": "items",
      "type": "SidebarItem[]",
      "required": true,
      "description": "链接和分组的树形结构。由 `getSidebar()` 从集合内容中构建。"
    },
    {
      "name": "persist",
      "type": "boolean",
      "required": false,
      "description": "将展开/滚动状态持久化到 sessionStorage，在页面导航间保持。"
    }
  ],
  "registryDependencies": [
    "badge",
    "collapsible",
    "cn"
  ],
  "dependencies": []
}
```