Transfer 穿梭框

规则

基础示例

Props 配置示例

可搜索

自定义标题与按钮、右侧排序

自定义数据字段

整段禁用

Events 事件示例

监听右侧变化与左右勾选

联动更新统计字段

完整配置项:Element_Transfer

value：array，为右侧列表当前选中项的 key 数组（类型与数据源中的 key 一致）。

Props

参数	说明	类型	默认值
modelValue / value	选中项绑定值（右侧已选项的 key 列表）	array	[]
data	数据源	array	[]
filterable	是否可搜索	boolean	false
filterPlaceholder	搜索框占位符	string	—
filterMethod	自定义搜索方法	Function	—
targetOrder	右侧列表排序策略：original 与数据源顺序一致；push 新项在后；unshift 新项在前	string	original
titles	左右列表标题	array	[]
buttonTexts	中间按钮文案	array	[]
renderContent	自定义数据项渲染函数	Function	—
format	列表顶部勾选状态文案	object	{}
props	数据项字段别名（如 key、label、disabled）	object	—
leftDefaultChecked	初始左侧已勾选的 key 数组	array	[]
rightDefaultChecked	初始右侧已勾选的 key 数组	array	[]
validateEvent	是否触发表单校验	boolean	true

Events

事件名	说明	类型
change	右侧列表元素变化时触发	Function
left-check-change	左侧列表项被勾选或取消勾选时触发	Function
right-check-change	右侧列表项被勾选或取消勾选时触发	Function

Slots

插槽名	说明
default	自定义数据项内容，参数为 { option }
left-footer	左侧列表底部
right-footer	右侧列表底部
left-empty	左侧无数据或筛选无结果时的占位
right-empty	右侧无数据或筛选无结果时的占位