2016-03-31 14:17:09 +08:00
|
|
|
|
---
|
|
|
|
|
category: Components
|
2016-09-21 11:28:38 +08:00
|
|
|
|
subtitle: 穿梭框
|
2022-11-09 12:28:04 +08:00
|
|
|
|
group: 数据录入
|
2016-09-21 11:28:38 +08:00
|
|
|
|
title: Transfer
|
2020-06-05 13:50:09 +08:00
|
|
|
|
cover: https://gw.alipayobjects.com/zos/alicdn/QAXskNI4G/Transfer.svg
|
2016-03-31 14:17:09 +08:00
|
|
|
|
---
|
2015-11-25 23:17:06 +08:00
|
|
|
|
|
2016-11-09 20:37:10 +08:00
|
|
|
|
双栏穿梭选择框。
|
2015-11-25 23:17:06 +08:00
|
|
|
|
|
|
|
|
|
## 何时使用
|
2015-12-24 20:47:09 +08:00
|
|
|
|
|
2018-12-07 14:23:04 +08:00
|
|
|
|
- 需要在多个可选项中进行多选时。
|
|
|
|
|
- 比起 Select 和 TreeSelect,穿梭框占据更大的空间,可以展示可选项的更多信息。
|
|
|
|
|
|
|
|
|
|
穿梭选择框用直观的方式在两栏中移动元素,完成选择行为。
|
2015-11-25 23:17:06 +08:00
|
|
|
|
|
2019-05-07 14:57:32 +08:00
|
|
|
|
选择一个或以上的选项后,点击对应的方向键,可以把选中的选项移动到另一栏。其中,左边一栏为 `source`,右边一栏为 `target`,API 的设计也反映了这两个概念。
|
2016-11-09 20:37:10 +08:00
|
|
|
|
|
2022-11-09 12:28:04 +08:00
|
|
|
|
## 代码演示
|
|
|
|
|
|
2022-11-17 17:31:26 +08:00
|
|
|
|
<!-- prettier-ignore -->
|
2022-11-09 12:28:04 +08:00
|
|
|
|
<code src="./demo/basic.tsx">基本用法</code>
|
|
|
|
|
<code src="./demo/oneWay.tsx">单向样式</code>
|
|
|
|
|
<code src="./demo/search.tsx">带搜索框</code>
|
|
|
|
|
<code src="./demo/advanced.tsx">高级用法</code>
|
|
|
|
|
<code src="./demo/custom-item.tsx">自定义渲染行数据</code>
|
|
|
|
|
<code src="./demo/large-data.tsx">分页</code>
|
|
|
|
|
<code src="./demo/table-transfer.tsx">表格穿梭框</code>
|
|
|
|
|
<code src="./demo/tree-transfer.tsx">树穿梭框</code>
|
|
|
|
|
<code src="./demo/status.tsx">自定义状态</code>
|
|
|
|
|
<code src="./demo/custom-select-all-labels.tsx" debug>自定义全选文字</code>
|
|
|
|
|
|
2015-11-25 23:17:06 +08:00
|
|
|
|
## API
|
|
|
|
|
|
2019-05-07 17:10:42 +08:00
|
|
|
|
### Transfer
|
|
|
|
|
|
|
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
|
| --- | --- | --- | --- | --- |
|
2022-04-27 10:07:16 +08:00
|
|
|
|
| dataSource | 数据源,其中的数据将会被渲染到左边一栏中,`targetKeys` 中指定的除外 | [RecordType extends TransferItem = TransferItem](https://github.com/ant-design/ant-design/blob/1bf0bab2a7bc0a774119f501806e3e0e3a6ba283/components/transfer/index.tsx#L12)\[] | \[] | |
|
2019-11-20 14:55:34 +08:00
|
|
|
|
| disabled | 是否禁用 | boolean | false | |
|
2020-07-01 20:18:48 +08:00
|
|
|
|
| filterOption | 接收 `inputValue` `option` 两个参数,当 `option` 符合筛选条件时,应返回 true,反之则返回 false | (inputValue, option): boolean | - | |
|
2021-06-30 12:10:23 +08:00
|
|
|
|
| footer | 底部渲染函数 | (props, { direction }) => ReactNode | - | direction: 4.17.0 |
|
2020-07-01 20:18:48 +08:00
|
|
|
|
| listStyle | 两个穿梭框的自定义样式 | object\|({direction: `left` \| `right`}) => object | - | |
|
2021-06-23 17:38:16 +08:00
|
|
|
|
| locale | 各种语言 | { itemUnit: string; itemsUnit: string; searchPlaceholder: string; notFoundContent: ReactNode \| ReactNode[]; } | { itemUnit: `项`, itemsUnit: `项`, searchPlaceholder: `请输入搜索内容` } | |
|
2020-05-13 19:15:40 +08:00
|
|
|
|
| oneWay | 展示为单向样式 | boolean | false | 4.3.0 |
|
2020-07-01 20:18:48 +08:00
|
|
|
|
| operations | 操作文案集合,顺序从上至下 | string\[] | \[`>`, `<`] | |
|
2021-09-30 17:45:26 +08:00
|
|
|
|
| operationStyle | 操作栏的自定义样式 | CSSProperties | - | |
|
2022-02-10 13:16:45 +08:00
|
|
|
|
| pagination | 使用分页样式,自定义渲染列表下无效 | boolean \| { pageSize: number, simple: boolean, showSizeChanger?: boolean, showLessItems?: boolean } | false | 4.3.0 |
|
2020-07-01 20:18:48 +08:00
|
|
|
|
| render | 每行数据渲染函数,该函数的入参为 `dataSource` 中的项,返回值为 ReactElement。或者返回一个普通对象,其中 `label` 字段为 ReactElement,`value` 字段为 title | (record) => ReactNode | - | |
|
2020-10-21 10:33:43 +08:00
|
|
|
|
| selectAllLabels | 自定义顶部多选框标题的集合 | (ReactNode \| (info: { selectedCount: number, totalCount: number }) => ReactNode)\[] | - | |
|
2019-05-07 17:22:47 +08:00
|
|
|
|
| selectedKeys | 设置哪些项应该被选中 | string\[] | \[] | |
|
|
|
|
|
| showSearch | 是否显示搜索框 | boolean | false | |
|
2019-11-20 14:55:34 +08:00
|
|
|
|
| showSelectAll | 是否展示全选勾选框 | boolean | true | |
|
2022-02-17 16:43:33 +08:00
|
|
|
|
| status | 设置校验状态 | 'error' \| 'warning' | - | 4.19.0 |
|
2019-05-07 17:22:47 +08:00
|
|
|
|
| targetKeys | 显示在右侧框数据的 key 集合 | string\[] | \[] | |
|
2020-07-01 20:18:48 +08:00
|
|
|
|
| titles | 标题集合,顺序从左至右 | ReactNode\[] | - | |
|
|
|
|
|
| onChange | 选项在两栏之间转移时的回调函数 | (targetKeys, direction, moveKeys): void | - | |
|
|
|
|
|
| onScroll | 选项列表滚动时的回调函数 | (direction, event): void | - | |
|
|
|
|
|
| onSearch | 搜索框内容时改变时的回调函数 | (direction: `left` \| `right`, value: string): void | - | |
|
|
|
|
|
| onSelectChange | 选中项发生改变时的回调函数 | (sourceSelectedKeys, targetSelectedKeys): void | - | |
|
2019-05-07 17:10:42 +08:00
|
|
|
|
|
|
|
|
|
### Render Props
|
|
|
|
|
|
2019-11-20 14:55:34 +08:00
|
|
|
|
Transfer 支持接收 `children` 自定义渲染列表,并返回以下参数:
|
2019-05-07 17:10:42 +08:00
|
|
|
|
|
2021-05-20 15:10:38 +08:00
|
|
|
|
| 参数 | 说明 | 类型 | 版本 |
|
|
|
|
|
| --------------- | -------------- | ------------------------------------ | ---- |
|
|
|
|
|
| direction | 渲染列表的方向 | `left` \| `right` | |
|
|
|
|
|
| disabled | 是否禁用列表 | boolean | |
|
|
|
|
|
| filteredItems | 过滤后的数据 | RecordType\[] | |
|
|
|
|
|
| selectedKeys | 选中的条目 | string\[] | |
|
|
|
|
|
| onItemSelect | 勾选条目 | (key: string, selected: boolean) | |
|
|
|
|
|
| onItemSelectAll | 勾选一组条目 | (keys: string\[], selected: boolean) | |
|
2019-05-07 17:10:42 +08:00
|
|
|
|
|
|
|
|
|
#### 参考示例
|
2019-05-07 17:22:47 +08:00
|
|
|
|
|
2019-05-07 17:10:42 +08:00
|
|
|
|
```jsx
|
2019-05-07 17:22:47 +08:00
|
|
|
|
<Transfer {...props}>{listProps => <YourComponent {...listProps} />}</Transfer>
|
2019-05-07 17:10:42 +08:00
|
|
|
|
```
|
2016-05-30 16:59:21 +08:00
|
|
|
|
|
|
|
|
|
## 注意
|
|
|
|
|
|
2020-11-08 15:04:02 +08:00
|
|
|
|
按照 React 的[规范](http://facebook.github.io/react/docs/lists-and-keys.html#keys),所有的组件数组必须绑定 key。在 Transfer 中,`dataSource` 里的数据值需要指定 `key` 值。对于 `dataSource` 默认将每列数据的 `key` 属性作为唯一的标识。
|
2016-05-30 16:59:21 +08:00
|
|
|
|
|
|
|
|
|
如果你的数据没有这个属性,务必使用 `rowKey` 来指定数据列的主键。
|
2016-11-04 15:16:16 +08:00
|
|
|
|
|
2016-05-30 16:59:21 +08:00
|
|
|
|
```jsx
|
|
|
|
|
// 比如你的数据主键是 uid
|
|
|
|
|
return <Transfer rowKey={record => record.uid} />;
|
2016-08-04 09:45:50 +08:00
|
|
|
|
```
|
2019-08-04 11:33:32 +08:00
|
|
|
|
|
|
|
|
|
## FAQ
|
|
|
|
|
|
|
|
|
|
### 怎样让 Transfer 穿梭框列表支持异步数据加载
|
|
|
|
|
|
2021-05-20 15:10:38 +08:00
|
|
|
|
为了保持页码同步,在勾选时可以不移除选项而以禁用代替:<https://codesandbox.io/s/objective-wing-6iqbx>
|