# UGJoin 连接容器

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

将按钮、输入框等控件连接为横向、纵向或响应式连续边界。

## 适用场景

- 把同一任务的按钮、输入框或选择控件连接为连续横向、纵向或响应式边界。

## 不适用场景

- 控件互不相关或需要正常间距时使用 Space；只组合按钮且需要组级外观默认值时优先 ButtonGroup。

## 公开入口

- 包入口：`@ug666/ui-vue/primitives`
- 公开成员：`UGJoin`、`UGJoinItem`
- 交互文档：[https://ui.ug666.top/vue/components/join](https://ui.ug666.top/vue/components/join)

```vue
import { UGJoin, UGJoinItem } from '@ug666/ui-vue/primitives'
```

## 使用规则

- 每个连续控件使用 UGJoinItem，并通过 as 渲染真实交互元素；组合需要可访问名称，窄屏布局使用 responsive。
- 双向值优先使用组件声明的 v-model 参数。
- 事件、插槽和 expose 以 Vue 类型为准，不照搬 React 回调名。
- 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。

## 相关候选

- [space](https://ui.ug666.top/ai/vue/components/space.md)
- [input](https://ui.ug666.top/ai/vue/components/input.md)

## 生成前检查

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