开发预览 更新于 2026-05-10

Transfer 穿梭框

两栏列表 + 中间箭头,把元素在「可选」与「已选」之间移动,常用于权限分配、字段勾选。

基础用法

dataSource 是全集,v-model / value 是已选 keys 数组。每栏有「全选 / 反选」复选框,箭头按钮把当前栏勾选项移到对侧。searchable 在每栏顶部加搜索框。

0 / 5
0 / 2
已选 keys:monitor, billing
<CfTransfer :data-source="data" v-model="target" searchable />
<CfTransfer dataSource={data} value={target} onChange={setTarget} searchable />

API

属性类型默认值说明
dataSourceTransferItem[]全集列表
value / modelValuestring[]受控的「已选」key 数组
defaultValuestring[][]非受控初始已选 keys
titles[string, string]['可选', '已选']两栏标题
searchablebooleanfalse显示搜索框

TransferItem

字段类型说明
keystring唯一 key
labelstring显示文本
disabledboolean禁用,不可勾选 / 移动

事件:onChange(keys) —— 已选 keys 数组变化时触发。

反馈与讨论

Transfer 穿梭框 的讨论

0
0 / 600
一键发送
正在加载评论...