selectron-react

    1.0.2 • Public • Published

    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.

    Install

    npm i selectron-react

    DownloadsWeekly Downloads

    1

    Version

    1.0.2

    License

    MIT

    Last publish

    Collaborators

    • dahliacreative