8b01286a5d | ||
---|---|---|
.. | ||
LICENSE.md | ||
README.md | ||
VERSION | ||
chosen.jquery.js | ||
chosen.jquery.min.js |
README.md
Chosen
Chosen is a library for making long, unwieldy select boxes more user friendly.
- jQuery support: 1.4+
- Prototype support: 1.7+
For documentation, usage, and examples, see:
http://harvesthq.github.com/chosen
Contributing to Chosen
Contributions and pull requests are very welcome. Please follow these guidelines when submitting new code.
- Make all changes in Coffeescript files, not JavaScript files.
- For feature changes, update both jQuery and Prototype versions
- Use 'cake build' to generate Chosen's JavaScript file and minified version.
- Don't touch the VERSION file
- Submit a Pull Request using GitHub.
Using CoffeeScript & Cake
First, make sure you have the proper CoffeeScript / Cake set-up in place.
- Install Coffeescript: the CoffeeScript documentation provides easy-to-follow instructions.
- Install UglifyJS:
npm -g install uglify-js
- Verify that your $NODE_PATH is properly configured using
echo $NODE_PATH
Once you're configured, building the JavasScript from the command line is easy:
cake build # build Chosen from source
cake watch # watch coffee/ for changes and build Chosen
If you're interested, you can find the recipes in Cakefile.
Chosen Credits
- Built by Harvest
- Concept and development by Patrick Filler
- Design and CSS by Matthew Lettini
Notable Forks
- Chosen for MooTools, by Jules Janssen
- Chosen Drupal 7 Module, by Pol Dell'Aiera