# UGDock 底部操作坞

> 适配器：Vue；状态：available；slug：`dock`。

提供适配移动端安全区、尺寸与当前页状态的底部导航。

## 适用场景

- 移动端需要始终可达的 3–5 个主要目的地或高频页面入口。

## 不适用场景

- 桌面端主导航使用 Navbar/NavigationMenu/Sidebar；临时动作使用 Fab；不要承载过多入口。

## 公开入口

- 包入口：`@ug666/ui-vue/components`
- 公开成员：`UGDock`、`UGDockItem`、`UGDockLabel`
- 交互文档：[https://ui.ug666.top/vue/components/dock](https://ui.ug666.top/vue/components/dock)

```vue
import { UGDock, UGDockItem, UGDockLabel } from '@ug666/ui-vue/components'
```

## 使用规则

- 导航根必须有可访问名称；当前页只标记一个 active 项；应用页面需保留底部安全区与内容避让。
- 双向值优先使用组件声明的 v-model 参数。
- 事件、插槽和 expose 以 Vue 类型为准，不照搬 React 回调名。
- 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。

## 相关候选

- [navbar](https://ui.ug666.top/ai/vue/components/navbar.md)
- [navigation-menu](https://ui.ug666.top/ai/vue/components/navigation-menu.md)
- [sidebar](https://ui.ug666.top/ai/vue/components/sidebar.md)

## 生成前检查

- 当前适配器是否真实提供该组件。
- 导入路径、组件名和 API 是否存在于当前版本类型声明。
- 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。