跳到主要内容

Transfer 穿梭框 ​

WebH5

穿梭框。左右双栏列表,通过勾选与操作按钮在两侧之间移动数据项,支持搜索过滤与禁用项。

何时使用 ​

需要在两个集合之间批量转移条目且要求明确展示可选/已选全貌时,如权限分配、成员挑选。

何时不使用 ​

选项很少(< 5)用 Checkbox 组;单选或简单多选用 Select。

Props ​

名称类型默认值说明
modelValuearray"[]"右侧(目标列表)已选 keys,对应 v-model
dataarray"—"必填。全部数据项:{ key: string|number; label: string; disabled?: boolean }[]
titles[string, string]"['源列表', '目标列表'](取 locale 文案 transfer.titles)"左右面板标题
filterablebooleanfalse在头部下方显示搜索框,按 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 文档(含手机预览)。