react-super-select
React Super Select aims to be a replacement for html select form elements.
This project is in nascent development stages.
Demo & Examples
Live demo and API docs: alsoscotland.github.io/react-super-select
To build and run the examples locally, run:
npm install
gulp rssdev
Then open 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
gulp rssdev
Please ensure any pull requests have jest specs and that all tests succeed when running
npm test
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.
Installation
The easiest way to use react-super-select is to install it from NPM and include it in your own React build process (using Browserify, Webpack, etc).
You can also use the standalone build by including dist/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
Dependencies
React-Super-Select requires
Usage
To use react super-select (jsx), require the module in your source code, and add a ReactSuperSelect element with a combination of the properties listed in the API docs or the Annotated Source
License
MIT License
Copyright (c) 2015 Scotland Stephenson.