Transfer 穿梭框

规则

基础示例

Props 配置示例

可搜索、尺寸与虚拟滚动

自定义过滤函数

整段禁用

Events 事件示例

完整配置项请参考: naive-ui_Transfer

value

• Array<string | number> | null；表单中常用数组表示右侧已选中的 value 集合。

Options（TransferOption）

字段名	说明	字段类型	是否必填	默认值
label	展示名称	string	是	-
value	唯一标识	string | number	是	-
disabled	是否禁用该项	boolean	否	false

Transfer Props

名称	类型	默认值	说明
clearText	string	undefined	清除按钮文案（2.35.0+）
defaultValue	Array<string | number> | null	null	非受控默认值（2.32.0+）
disabled	boolean	false	是否禁用整组件（以 Naive UI 实际版本为准）
filter	(pattern, option, from) => boolean	内置标签匹配	搜索过滤；from 为 source | target（2.32.2+）
options	TransferOption[]	[]	选项数据
renderSourceLabel	(props) => VNodeChild	undefined	自定义源侧标签
renderTargetLabel	(props) => VNodeChild	undefined	自定义目标侧标签
renderSourceList	(props) => VNodeChild	undefined	自定义源列表
renderTargetList	(props) => VNodeChild	undefined	自定义目标列表（2.33.4+）
selectAllText	string	undefined	全选按钮文案（2.35.0+）
showSelected	boolean	true	是否在源列表展示已选项（2.34.0+）
size	'small' | 'medium' | 'large'	'medium'	尺寸
sourceFilterable	boolean	false	源列表是否可过滤（2.32.2+）
sourceFilterPlaceholder	string	undefined	源搜索框占位
sourceTitle	string | () => VNodeChild	undefined	源列表标题（2.40.0+ 支持 render）
targetFilterable	boolean	false	目标列表是否可过滤（2.32.2+）
targetFilterPlaceholder	string	undefined	目标搜索框占位
targetTitle	string | () => VNodeChild	undefined	目标列表标题（2.40.0+ 支持 render）
value	Array<string | number> | null	undefined	受控值
onUpdateValue	(value: Array<string | number>) => void	undefined	值变化回调（2.32.0+）
virtualScroll	boolean	false	虚拟滚动（2.32.0+）