# Project switcher

https://fieldbook.lizardi.mx/zh/components/project-switcher

分类：导航
缩略图：https://fieldbook.lizardi.mx/thumbs/project-switcher.webp

Project switcher：搜索可用项目，切换当前项目，并显示选择反馈。

## 框架

react、vue、svelte、astro、html

## 预览控件

这些控件会传给演示组件。默认值和限制描述的是预览；完整的属性接口请查看实现代码。

| 名称 | 类型 | 默认值 | 选项或限制 |
| --- | --- | --- | --- |
| accent | color | #62C6D8 | 元数据未列出其他限制。 |
| status | select | ready | 选项：ready、loading、empty、error |

## 使用说明

搜索可用项目，并通过可见的选择反馈切换当前项目。React 受控用法需传入 value 和 onChange；onAction 接收操作及结果状态。使用 defaultValue 创建本地草稿。

Project switcher 的预览采用「卡片」布局，主题设置为「深色」。

搜索 Client 并选择 Client dashboard。当前项目标签会更新，页面不会跳转。此示例仅更新本地草稿状态。

此组件维护示例用的本地状态。宿主应用必须持久化变更，并执行身份、权限及策略控制。

### 应用如何接收变更？

React 受控用法需传入 value 和 onChange；onAction 接收操作及结果状态。使用 defaultValue 创建本地草稿。

### Project switcher 提供哪些框架版本？

Project switcher 提供 React、Vue、Svelte、Astro、HTML 版本。实时预览使用 React；以下代码观察仅针对 index.tsx。使用其他版本前，请确认其交互行为。

### Project switcher 有哪些依赖？

React 元数据列出的额外 npm 依赖为：clsx、tailwind-merge。

### Project switcher 的代码中有哪些无障碍细节？

Project switcher 的 React 代码包含：原生元素（button、fieldset、input、label）；属性与事件处理器（aria-hidden、aria-label、aria-live、aria-pressed）；显式角色（status）。这些信息来自代码观察。请在组合后的页面中验证无障碍名称、焦点顺序和键盘行为。

### Project switcher 如何处理减少动态效果的偏好？

代码扫描未在 Project switcher 的 index.tsx 中发现通过 useReducedMotion() 或 matchMedia 直接读取偏好的代码。请启用减少动态效果，检查完整实现、共享样式和所选框架版本；这些观察不能证明所有动画都会停止。

## 通过 MCP 安装

连接客户端，调用 get_component 获取实现，再调用 get_install_command 获取安装说明。选择已列出的框架，将源代码集成到应用中并验证功能。

```json
{
  "tool": "get_component",
  "arguments": {
    "slug": "project-switcher",
    "framework": "react"
  }
}
```

[面向智能体](https://fieldbook.lizardi.mx/zh/docs/agents)
[MCP](https://fieldbook.lizardi.mx/api/mcp)

## 相关开放组件

- [Auto height tabs](https://fieldbook.lizardi.mx/zh/components/auto-height-tabs)
- [Bubble burst menu](https://fieldbook.lizardi.mx/zh/components/bubble-burst-menu)
- [Card blur tabs](https://fieldbook.lizardi.mx/zh/components/card-blur-tabs)
- [Chameleon pill navbar](https://fieldbook.lizardi.mx/zh/components/chameleon-pill-navbar)
- [Dock menu](https://fieldbook.lizardi.mx/zh/components/dock-menu)
- [Dropdown Action Menu](https://fieldbook.lizardi.mx/zh/components/dropdown-action-menu)