---
url: /components/transfer.md
---
# Transfer 穿梭框

双栏数据搬运：勾选左侧候选后点击按钮移入右侧（`modelValue` 为右侧 `key` 数组），支持搜索过滤。

## 基础用法

## 单向模式

`one-way` 开启后隐藏右到左的回移按钮，并收起已选区的勾选入口（行内与表头），数据只从左向右移动——适合「确认即生效」的分配场景。

## 自定义行内容

`item` 作用域插槽两栏共用，暴露 `item`（行数据）与 `direction`（left / right，来源面板）；未提供插槽时回退渲染 `label` 纯文本。

## Transfer API

| 名称 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| modelValue | Array | `[]` | 右侧已选项的 key 数组（v-model） |
| data | Array | `[]` | 全量数据，项为 `{ key, label }` |
| titles | Array | `['列表 1', '列表 2']` | 左右栏标题，缺省取当前语言包 |
| filterable | Boolean | `false` | 开启搜索 |
| filter-placeholder | String | 取语言包（中文为 请输入搜索内容） | 搜索占位 |
| disabled | Boolean | `false` | 整体禁用：移动按钮、勾选框与搜索框联动 |
| one-way | Boolean | `false` | 单向模式：隐藏回移按钮与已选区勾选入口，数据只从左向右移动 |

事件：`update:modelValue`、`change(keys)`。