jjj / chosen
Chosen is a JavaScript plugin that makes select boxes user-friendly. It is currently available in both jQuery and Prototype flavors.
Package info
Language:CoffeeScript
Type:npm-asset
pkg:composer/jjj/chosen
Requires
None
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
- dev-master
- 3.0.4
- 3.0.3
- 3.0.2
- 3.0.1
- 3.0.0
- 2.2.1
- 2.2.0
- 2.1.1
- 2.1.0
- v1.8.7
- v1.8.6
- dev-jjj/harvest-2981-ajax-guidance
- dev-jjj/harvest-3065-keypress-guidance
- dev-jjj/harvest-2783-cyrillic-guidance
- dev-jjj/harvest-3149-whitespace-options
- dev-jjj/harvest-3146-csp
- dev-jjj/harvest-79-triage-link
- dev-jjj/harvest-79-remote-recipe
- dev-jjj/word-boundary-normalized-highlight
- dev-jjj/harvest-pr-2898-word-boundary
- dev-jjj/native-react-style-audit
- dev-jjj/relative-sizing
- dev-release_documentation
This package is auto-updated.
Last update: 2026-10-01 23:43:25 UTC
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)
- Experimental vanilla JavaScript adapter: no framework runtime dependency
The classic adapter browser suite runs in Chrome; the native, React, and touch suites also run in WebKit. 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, vanilla demo, and React demo, plus the options reference. The wiki covers setup and common workflows.
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 versionchosen.proto.js/chosen.proto.min.js- Prototype versionchosen.css/chosen.min.css- Styleschosen.css.map- CSS source mapnative/chosen.native.js/native/chosen.css- experimental vanilla edition
The /docs directory also contains copies of these files for GitHub Pages.
GitHub Pages publishes it automatically when changes reach master.
Each release includes both a
full archive and a compiled distribution archive.
Package managers
To install with npm:
npm install chosen-jjj
The default package entry loads the jQuery adapter through browser globals, AMD, or CommonJS. CommonJS consumers should install jQuery alongside Chosen and provide a DOM before requiring the packages. Explicit entries for the Prototype adapter, shared CSS, Sass, and the experimental framework-neutral ESM/CommonJS core are described in the package boundaries. The experimental vanilla adapter is described in the vanilla guide, and the native React component in the React guide. Their remaining gaps are tracked in the adapter parity inventory.
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.
Before opening an issue, see support and discussion routes. Please follow our Code of Conduct. For a potential security issue, use the private reporting instructions instead of a public issue.
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