jyotirmaybanerjee / react-duallist

A React searchable and sortable and fully customizable dual list. It supports custom icons.
https://rawgit.com/jyotirmaybanerjee/react-duallist/master/example/examples.html
MIT License
6 stars 5 forks source link
custom-icons dual-list listbox multiselect react searchable sortable

react-duallist

A React based searchable, sortable and fully customizable dual list.

Demo

Install

npm install react-duallist --save

or

yarn add react-duallist

Use

  import Duallist from 'react-duallist';

  import 'react-duallist/lib/react_duallist.[css|less|scss|sass]'
    <Duallist
      available={available}
      selected={selected}
      onSelect={this.onSelect}
    />

options

Option Description Default Value Required
available List of available options, will appear in the left box true
selected List of selected options, will appear in the right box true, atleast need to pass an empty array
onSelect A callback to handle the change in the selected list true
leftLabel A header for the left (available) list Available
rightLabel A header for the right (selected) list Selected
sortable A false value will hide the reorder buttons on the right true
searchable A false value will hide the search field on the top true
moveLeftIcon fontawesome icons or icon of your choice <
moveAllLeftIcon fontawesome icons or icon of your choice <<
moveRightIcon fontawesome icons or icon of your choice >
moveAllRightIcon fontawesome icons or icon of your choice >>
moveUpIcon fontawesome icons or icon of your choice
moveTopIcon fontawesome icons or icon of your choice
moveDownIcon fontawesome icons or icon of your choice
moveBottomIcon fontawesome icons or icon of your choice

Tests

npm test

or yarn test

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code.

Release History