Transfer 穿梭框

双栏穿梭选择框。

何时使用#

用直观的方式在两栏中移动元素，完成选择行为。

API#

参数	说明	类型	默认值
dataSource	数据源	Array	[]
render	每行数据渲染函数	Function(record)
targetKeys	显示在右侧框数据的key集合	Array	[]
onChange	变化时回调函数	Function(newTargetKeys)
listStyle	两个穿梭框的自定义样式	Object
className	自定义类	String
titles	标题集合,顺序从左至右	Array	['源列表', '目的列表']
operations	操作文案集合,顺序从上至下	Array	[]
showSearch	是否显示搜索框	Boolean	false
searchPlaceholder	搜索框的默认值	String	请输入搜索的内容
footer	底部渲染函数	Function(props)

代码演示

import { Transfer, Button } from 'antd';

const App = React.createClass({
  getInitialState() {
    return {
      mockData: [],
      targetKeys: [],
    };
  },
  componentDidMount() {
    this.getMock();
  },
  getMock() {
    let targetKeys = [];
    let mockData = [];
    for (let i = 0; i < 20; i++) {
      const data = {
        key: i,
        title: '内容' + (i + 1),
        description: '内容' + (i + 1) + '的描述',
        chosen: Math.random() * 2 > 1
      };
      if (data.chosen) {
        targetKeys.push(data.key);
      }
      mockData.push(data);
    }
    this.setState({ mockData, targetKeys });
  },
  handleChange(targetKeys) {
    this.setState({ targetKeys });
  },
  renderFooter() {
    return <Button type="primary" size="small" style={{ float: 'right', margin: '5' }}
                   onClick={this.getMock}>刷新</Button>;
  },
  render() {
    return (
      <Transfer
        dataSource={this.state.mockData}
        targetKeys={this.state.targetKeys}
        onChange={this.handleChange}
        render={item => item.title} />
    );
  }
});

ReactDOM.render(<App />, mountNode);

基本用法

最基本的用法。

import { Transfer } from 'antd';

const App = React.createClass({
  getInitialState() {
    return {
      mockData: [],
      targetKeys: [],
    };
  },
  componentDidMount() {
    this.getMock();
  },
  getMock() {
    let targetKeys = [];
    let mockData = [];
    for (let i = 0; i < 20; i++) {
      const data = {
        key: i,
        title: '内容' + (i + 1),
        description: '内容' + (i + 1) + '的描述',
        chosen: Math.random() * 2 > 1
      };
      if (data.chosen) {
        targetKeys.push(data.key);
      }
      mockData.push(data);
    }
    this.setState({ mockData, targetKeys });
  },
  handleChange(targetKeys) {
    this.setState({ targetKeys });
  },
  render() {
    return (
      <Transfer
        dataSource={this.state.mockData}
        showSearch
        targetKeys={this.state.targetKeys}
        onChange={this.handleChange}
        render={item => item.title} />
    );
  }
});

ReactDOM.render(<App />, mountNode);

带搜索框

带搜索框的穿梭框。

import { Transfer, Button } from 'antd';
const container = mountNode;

const App = React.createClass({
  getInitialState() {
    return {
      mockData: [],
      targetKeys: [],
    };
  },
  componentDidMount() {
    this.getMock();
  },
  getMock() {
    let targetKeys = [];
    let mockData = [];
    for (let i = 0; i < 20; i++) {
      const data = {
        key: i,
        title: '内容' + (i + 1),
        description: '内容' + (i + 1) + '的描述',
        chosen: Math.random() * 2 > 1
      };
      if (data.chosen) {
        targetKeys.push(data.key);
      }
      mockData.push(data);
    }
    this.setState({ mockData, targetKeys });
  },
  handleChange(targetKeys) {
    this.setState({ targetKeys });
  },
  renderFooter() {
    return <Button type="ghost" size="small" style={{ float: 'right', margin: '5' }}
                   onClick={this.getMock}>刷新</Button>;
  },
  render() {
    return (
      <Transfer
        dataSource={this.state.mockData}
        showSearch
        listStyle={{
          width: 250,
          height: 300,
        }}
        operations={['向右操作文案', '向左操作文案']}
        targetKeys={this.state.targetKeys}
        onChange={this.handleChange}
        render={item => item.title + '-' + item.description}
        footer={this.renderFooter} />
    );
  }
});

ReactDOM.render(<App />, container);

高级用法

穿梭框高级用法，可配置操作文案，可定制宽高，可对底部进行自定义渲染。