2011-08-05 06:11:15 +02:00
|
|
|
|
# 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
|
2012-03-05 14:03:35 +01:00
|
|
|
|
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.
|
2011-08-05 06:11:15 +02:00
|
|
|
|
|
|
|
|
|
|
### Using CoffeeScript & Cake
|
|
|
|
|
|
|
2012-03-05 14:03:35 +01:00
|
|
|
|
First, make sure you have the proper CoffeeScript / Cake set-up in place. We have added a package.json that makes this easy:
|
2011-08-05 06:11:15 +02:00
|
|
|
|
|
2012-03-05 14:03:35 +01:00
|
|
|
|
```
|
|
|
|
|
|
npm install -d
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
This will install `coffee-script` and `uglifyjs`.
|
2011-08-05 06:11:15 +02:00
|
|
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
|
2012-01-03 12:07:33 +01:00
|
|
|
|
- Built by [Harvest](http://www.getharvest.com/). Want to work on projects like this? [We’re hiring](http://www.getharvest.com/careers)!
|
2011-08-05 06:11:15 +02:00
|
|
|
|
- Concept and development by [Patrick Filler](http://www.patrickfiller.com/)
|
|
|
|
|
|
- Design and CSS by [Matthew Lettini](http://matthewlettini.com/)
|
|
|
|
|
|
|
|
|
|
|
|
### Notable Forks
|
|
|
|
|
|
|
|
|
|
|
|
- [Chosen for MooTools](https://github.com/julesjanssen/chosen), by Jules Janssen
|
2012-03-05 14:03:35 +01:00
|
|
|
|
- [Chosen Drupal 7 Module](http://drupal.org/project/chosen), by Pol Dell'Aiera, Arshad Chummun, Bart Feenstra, Kálmán Hosszu, etc.
|
|
|
|
|
|
- [Chosen CakePHP Plugin](https://github.com/paulredmond/chosen-cakephp), by Paul Redmond
|
