Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

uxcore-transfer

uxcore126MIT0.4.4

transfer ui component for react

react, react-component, react-transfer, transfer

readme

uxcore-transfer


TL;DR

transfer ui component for react

setup develop environment

$ git clone https://github.com/uxcore/uxcore-transfer
$ cd uxcore-transfer
$ npm install
$ npm run dev

Usage

let Transfer = require("uxcore-transfer");
let mockData = [];
let len = Math.random() * 10 + 40;
for (let i = 0; i < len; i++) {
    mockData.push({
        name: '内容' + (i + 1),
        value: (i + 1),
        description: '内容' + (i + 1) + '的描述',
        chosen: Math.random() * 2 > 1,
        keywords: ['neirong' + (i + 1)], // used in search & location
        disabled: i > 15
    });
}

class TransferDemo extends React.Component {
    constructor(props){
        super(props);
        this.state = {
            disable: false
        }
    }

    _handleChange(data) {
        console.log(data);
    }

    handleClick() {
        this.refs.transfer.selectItems([2, 3]);
    }

    handleClick2() {
        this.setState({
            disable: !this.state.disable
        })
    }

    render() {
        var me = this;
        return (
            <div>
                <Transfer showSearch={true} disabled={me.state.disable} ref="transfer" data={mockData} onChange={me._handleChange.bind(me)}/>
                <Button onClick={me.handleClick.bind(me)}>手动更改被选中的项</Button>
                <Button onClick={me.handleClick2.bind(me)}>更改 mode</Button>
            </div>
        );
    }
}

demo

http://uxcore.github.io/uxcore/components/transfer/

API

  • selectItems(arr): 使对应 value 的变成高亮状态 (selected)。 参数:
    • arr Array 一个由 value 组成的数组。
  • reset(): 使 Transfer 回到与 data 对应的状态。

Props

参数 类型 必需 默认值 说明
height number optional 220 transfer高度
data array required - 用于初始化 transfer 的数据,格式见 Usage,其中 name 和 value 字段必有
disabled boolean optional false 是否启用 disable 模式
showSearch boolean optional true 是否显示搜索条
searchPlaceholder string optional 定位输入内容
leftTitle string optional '未选中的' 左侧标题
rightTitle string optional '已选中的' 右侧标题
onChange func optional noop 选中情况变化时触发,返回选中和未选中的项
isAsc boolean optional false 是否让新穿梭的值排在尾部

changelog

0.4.3

  • FIXED #23

0.4.2

  • CHANGED style adjustment

0.4.1

CHANGED support js style export

0.4.0

  • CHANGED fit React@16

0.3.16

  • FIXED #18
  • FIXED search icon changed to uxcore-sousuo

0.3.15

  • FIXED fix some styles not compatible with last design

0.3.14

  • FIXED fix color to comply with design rules.

0.3.13

  • CHANGED add disabled option to transfer item

0.3.12

  • CHANGED replace dependency deepcopy with lodash/cloneDeep

0.3.11

  • CHANGED fit React@15

0.3.10

  • FIXED text overflow style bug

0.3.9

  • CHANGED eslint
  • CHANGED style change

0.3.5

  • CHANGED style change

0.3.4

  • CHANGED remove head background color

0.3.3

  • CHANGED fix table width to 380px
  • CHANGED search input placeholder

0.3.2

FIXED fix bug in locateItem, index do not match

0.3.1

FIXED fix bug in locateItem and _removeJustMoved

0.3.0

CHANGED apply new style CHANGED add height props

0.2.8

CHANGED new dev tool CHANGED highlight item when search CHANGED repository

0.2.7

CHANGED update scaffold

0.2.5

CHANGED items which has just been moved will not be selected.

0.2.3

NEW add API reset CHANGE update style

0.2.2

FIX fix title bug

0.2.1

FIX fix bug when reset prop data.

0.2.0

NEW add searchBar & disable mode