Chosen is a library for making long, unwieldy select boxes more friendly.
 
 
 
 
Go to file
Patrick Filler 2f196b118c Make group selection optional. 2012-02-28 10:52:03 -05:00
chosen Make group selection optional. 2012-02-28 10:52:03 -05:00
coffee Make group selection optional. 2012-02-28 10:52:03 -05:00
.gitignore Merge master into abstract-chosen 2011-09-30 17:39:03 -04:00
Cakefile Add a package npm task and check in a generated file 2012-01-13 11:01:30 -05:00
LICENSE.md Update License Info 2011-07-13 15:42:57 -04:00
README.md Merge branch 'cakephp-fork' of https://github.com/paulredmond/chosen into paulredmond-cakephp-fork 2012-01-19 16:41:26 -06:00
VERSION Version 0.9.7 2012-01-19 17:49:44 -06:00
example.jquery.html Silly typo. 2011-10-24 11:02:26 -04:00
example.proto.html Typo on Prototype example page 2012-01-12 17:17:57 -06:00
package.json Updating version numbers. 2012-01-19 17:52:30 -06: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 npm install -d to install the correct development dependencies.
  4. Use cake build or cake watch to generate Chosen's JavaScript file and minified version.
  5. Don't touch the VERSION file
  6. Submit a Pull Request using GitHub.

Using CoffeeScript & Cake

First, make sure you have the proper CoffeeScript / Cake set-up in place. We have added a package.json that makes this easy:

npm install -d

This will install coffee-script and uglifyjs.

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