# UGFab 浮动操作组

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

提供可控的浮动主操作与纵向或扇形快捷动作组。

## 适用场景

- 页面存在一个高优先级主动作，或需要展开少量相关快捷动作。

## 不适用场景

- 普通表单操作使用 Button；超过 4 个动作使用 Dropdown/Sheet；不要遮挡 Dock 和关键内容。

## 公开入口

- 包入口：`@ug666/ui-vue/components`
- 公开成员：`UGFab`、`UGFabTrigger`、`UGFabActions`、`UGFabAction`
- 交互文档：[https://ui.ug666.top/vue/components/fab](https://ui.ug666.top/vue/components/fab)

```vue
import { UGFab, UGFabTrigger, UGFabActions, UGFabAction } from '@ug666/ui-vue/components'
```

## 使用规则

- Trigger 必须有可访问名称；Actions/Action 必须在 Fab 内使用；业务可控制 open，选择动作默认关闭并支持 Escape。
- 双向值优先使用组件声明的 v-model 参数。
- 事件、插槽和 expose 以 Vue 类型为准，不照搬 React 回调名。
- 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。

## 相关候选

- [button](https://ui.ug666.top/ai/vue/components/button.md)
- [dropdown](https://ui.ug666.top/ai/vue/components/dropdown.md)
- [dock](https://ui.ug666.top/ai/vue/components/dock.md)

## 生成前检查

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