Selectron React

A simple select replacement component built with & for React.Js

I built this select replacement as I was frustrated with the UX other react select replacements offered. I found other solutions over engineered, complicated to use and ultimatley not user friendly.

See some examples / docs at https://dahliacreative.github.io/selectron-react/

Installation

npm install selectron-react

or

yarn add selectron-react

Usage

<Selectron
        options={[{
            value: 'England',
            label: 'England'
        },{
            value: 'Wales',
            label: 'Wales'
        },{
            value: 'Scotland,
            label: 'Scotland'
        },{
            value: 'Northern Ireland',
            label: 'Northern Ireland'
        }]}
        onChange={(value) => {this.setState({value})}}
        value={this.state.value}/>

Options

Prop	Type	Required	Default	Description
options	array	Yes	[]	an array of option objects, requires value and label params
value	object/array	No	null	an option object / array of option objects, requires value and labelparams
onChange	function	Yes	() => {}	a function to be called when the select changes, recieves value as param
onSearch	function	No		a function to be called when the user searches, recieves term as param. used for ajaxing in options
multi	bool	No	false	allow multiple options
placeholder	string	No	Please select...	placeholder to display
clearable	bool	No	true	allows user to clear value once an option is selected
searchable	bool	No	true	allows user to filter the options list
required	bool	No	false	adds HTML5 required attribute to hidden inputs
name	string	No	selectron-react-value	HTML name attribute add to hidden fields

License

Copyright (c) 2017 Simon Sturgess

Licensed under the MIT license.