1.0.2 • Published 8 years ago
selectron-react v1.0.2
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-reactor
yarn add selectron-reactUsage
<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.