A flexible replacement for the html select control built with React and Lodash
- template capability for options
- aria-compliant keyboard navigation
- multiselect & tags
- ajax support
- ajax paging/load-more support
- grouped options under headings
- easy style customization
- localization support
- extensible default css (must copy css file into your application)
Demo & Examples
Live demo and API docs: alsoscotland.github.io/react-super-select
To build and run the examples locally, run:
npm install npm run build gulp dev
You may also have to create a tmp directory manually.
localhost:8000 in a browser.
development and contributions
Feedback, issue reports, and feature requests are welcome. There is a provided gulp task for running a dev environment with live linting
Please ensure any pull requests have jest specs and that all tests succeed when running
Watching for changes and live linting. jshint for js and recess errors for less will report to the console
A note on accessibility
Aria support for accessibility is a clear objective for this control. Finding clear and accurate information regarding cross-device accessibility practices is proving difficult to come by. If you are a daily screen-reader user, or if you have particular expertise regarding accessibility, I would love to get your input on how to make the control better.
You can also use the standalone build by including
lib/react-super-select.js in your page. If you use this, make sure you have already included React, and it is available as a global variable.
npm install react-super-select --save
bower install react-super-select
var ReactSuperSelect = ;
copy the css file from the lib/ folder of
node_modules/react-super-select (react-super-select.css) into your app's css directory
v1.0.0 - Stable release version one: Upgrade for React v15.5.4 support
Copyright (c) 2016 Scotland Stephenson.