Chosen is a library for making long, unwieldy select boxes more friendly.
 
 
 
 
Go to file
Matthew Beale 47b7b4d6bc Merge master into abstract-chosen 2011-09-30 17:39:03 -04:00
chosen Merge master into abstract-chosen 2011-09-30 17:39:03 -04:00
coffee Merge master into abstract-chosen 2011-09-30 17:39:03 -04:00
.gitignore Merge master into abstract-chosen 2011-09-30 17:39:03 -04:00
Cakefile Introduce abstract-chosen, try to start sharing more code between platforms 2011-08-19 12:23:03 -04:00
LICENSE.md Update License Info 2011-07-13 15:42:57 -04:00
README.md Don't update VERSION, please. 2011-07-31 22:54:53 +03:00
VERSION Up version number to 0.9.5 2011-09-30 12:21:05 -04:00
example.jquery.html Add deselect examples. 2011-09-28 13:29:00 -04:00
example.proto.html Add deselect examples. 2011-09-28 13:29:00 -04:00

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.

  1. Make all changes in Coffeescript files, not JavaScript files.
  2. For feature changes, update both jQuery and Prototype versions
  3. Use 'cake build' to generate Chosen's JavaScript file and minified version.
  4. Don't touch the VERSION file
  5. Submit a Pull Request using GitHub.

Using CoffeeScript & Cake

First, make sure you have the proper CoffeeScript / Cake set-up in place.

  1. Install Coffeescript: the CoffeeScript documentation provides easy-to-follow instructions.
  2. Install UglifyJS: npm -g install uglify-js
  3. 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

Notable Forks