Transfer 穿梭框
WebH5
穿梭框。左右双栏列表,通过勾选与操作按钮在两侧之间移动数据项,支持搜索过滤与禁用项。
何时使用
需要在两个集合之间批量转移条目且要求明确展示可选/已选全貌时,如权限分配、成员挑选。
何时不使用
选项很少(< 5)用 Checkbox 组;单选或简单多选用 Select。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | array | "[]" | 右侧(目标列表)已选 keys,对应 v-model |
data | array | "—" | 必填。全部数据项:{ key: string|number; label: string; disabled?: boolean }[] |
titles | [string, string] | "['源列表', '目标列表'](取 locale 文案 transfer.titles)" | 左右面板标题 |
filterable | boolean | false | 在头部下方显示搜索框,按 label 包含过滤 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | (string|number)[] | 移动后触发,携带最新的右侧已选 keys |
change | (keys: (string|number)[], direction: 'left'|'right') | 移动后触发,direction 表示移动方向:right 移入目标列表、left 移回源列表 |
示例
权限分配(可搜索)
示例加载中…
成员挑选
示例加载中…
事件监听
示例加载中…
无搜索栏
示例加载中…
Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Transfer 文档(含手机预览)。