thatsus/select2

Select2 is a jQuery based replacement for select boxes.

Select2

![Build Status][travis-ci-image], _(*1)

Select2 is a jQuery-based replacement for select boxes. It supports searching, remote data sets, and pagination of results., _(*2)

To get started, checkout examples and documentation at https://select2.github.io/, _(*3)

Use cases

• Enhancing native selects with search.
• Enhancing native selects with a better multi-select interface.
• Loading data from JavaScript: easily load items via AJAX and have them searchable.
• Nesting optgroups: native selects only support one level of nesting. Select2 does not have this restriction.
• Tagging: ability to add new items on the fly.
• Working with large, remote datasets: ability to partially load a dataset based on the search term.
• Paging of large datasets: easy support for loading more pages when the results are scrolled to the end.
• Templating: support for custom rendering of results and selections.

Browser compatibility

• IE 8+
• Chrome 8+
• Firefox 10+
• Safari 3+
• Opera 10.6+

Usage

You can source Select2 directly from a CDN like JSDliver or CDNJS, download it from this GitHub repo, or use one of the integrations below., _(*4)

Integrations

• Wicket-Select2 (Java / Apache Wicket)
• select2-rails (Ruby on Rails)
• AngularUI (AngularJS)
• Django
• Symfony
• Symfony2
• Bootstrap 2 and Bootstrap 3 (CSS skins)
• Meteor (Bootstrap 3 skin)
• Meteor
• Yii 2.x
• Yii 1.x
• AtmosphereJS

Internationalization (i18n)

Select2 supports multiple languages by simply including the right language JS file (dist/js/i18n/it.js, dist/js/i18n/nl.js, etc.) after dist/js/select2.js., _(*5)

Missing a language? Just copy src/js/select2/i18n/en.js, translate it, and make a pull request back to Select2 here on GitHub., _(*6)

Documentation

The documentation for Select2 is available through GitHub Pages and is located within this repository in the docs folder., _(*7)

Community

You can find out about the different ways to get in touch with the Select2 community at the Select2 community page., _(*8)

Copyright and license

The license is available within the repository in the LICENSE file., _(*9)