README

Chosen is a library for making long, unwieldy select boxes more user friendly.

• jQuery support: 1.7+ (tested with 1.7, 1.12, 3.5, and 4.0)
• Prototype support: 1.7+ (tested with 1.7)

The automated browser suites run in Chrome. Chosen's original compatibility target included Firefox, Safari, and Internet Explorer 9; those browsers are not currently covered by this fork's automated tests. Please include your browser and library versions when reporting a compatibility issue.

For documentation, usage, and examples, see the jQuery demo, Prototype demo, and options reference.

For downloads, see the GitHub releases.

Compiled Assets

The compiled JavaScript and CSS files are located in the /dist directory. This directory contains:

• chosen.jquery.js / chosen.jquery.min.js - jQuery version
• chosen.proto.js / chosen.proto.min.js - Prototype version
• chosen.css / chosen.min.css - Styles
• chosen.css.map - CSS source map

The /docs directory also contains copies of these files for GitHub Pages. Each release includes both a full archive and a compiled distribution archive.

Package managers

To install with npm:

npm install chosen-jjj

To install with Composer:

composer require jjj/chosen

Contributing to this project

We welcome all to participate in making Chosen the best software it can be. The repository is maintained by only a few people, but has accepted contributions from over 50 authors after reviewing hundreds of pull requests related to thousands of issues. You can help reduce the maintainers' workload (and increase your chance of having an accepted contribution to Chosen) by following the guidelines for contributing.

• Bug reports
• Feature requests
• Pull requests

Chosen Credits

• Concept and development by Patrick Filler for Harvest
• Design and CSS by Matthew Lettini
• 1.8.x and earlier maintained by @pfiller, @kenearley, @stof, @koenpunt, and @tjschuck
• 2.0.x and later maintained by @JJJ and contributors
• Chosen includes contributions by many fine folks