i18n
4 years ago
LICENSE
4 years ago
README.md
4 years ago
select2.css
4 years ago
select2.full.js
4 years ago
select2.full.min.js
4 years ago
select2.min.css
4 years ago
README.md
162 lines
| 1 | Select2 |
| 2 | ======= |
| 3 | ![Build Status][github-actions-image] |
| 4 | [](https://opencollective.com/select2](https://opencollective.com/select2](https://opencollective.com/select2) |
| 5 | [][jsdelivr] |
| 6 | [][cdnjs] |
| 7 | |
| 8 | Select2 is a jQuery-based replacement for select boxes. It supports searching, |
| 9 | remote data sets, and pagination of results. |
| 10 | |
| 11 | To get started, checkout examples and documentation at |
| 12 | https://select2.org/ |
| 13 | |
| 14 | Use cases |
| 15 | --------- |
| 16 | * Enhancing native selects with search. |
| 17 | * Enhancing native selects with a better multi-select interface. |
| 18 | * Loading data from JavaScript: easily load items via AJAX and have them |
| 19 | searchable. |
| 20 | * Nesting optgroups: native selects only support one level of nesting. Select2 |
| 21 | does not have this restriction. |
| 22 | * Tagging: ability to add new items on the fly. |
| 23 | * Working with large, remote datasets: ability to partially load a dataset based |
| 24 | on the search term. |
| 25 | * Paging of large datasets: easy support for loading more pages when the results |
| 26 | are scrolled to the end. |
| 27 | * Templating: support for custom rendering of results and selections. |
| 28 | |
| 29 | Browser compatibility |
| 30 | --------------------- |
| 31 | * IE 8+ |
| 32 | * Chrome 8+ |
| 33 | * Firefox 10+ |
| 34 | * Safari 3+ |
| 35 | * Opera 10.6+ |
| 36 | |
| 37 | Usage |
| 38 | ----- |
| 39 | You can source Select2 directly from a CDN like [jsDelivr][jsdelivr] or |
| 40 | [cdnjs][cdnjs], [download it from this GitHub repo][releases], or use one of |
| 41 | the integrations below. |
| 42 | |
| 43 | Integrations |
| 44 | ------------ |
| 45 | Third party developers have created plugins for platforms which allow Select2 to be integrated more natively and quickly. For many platforms, additional plugins are not required because Select2 acts as a standard `<select>` box. |
| 46 | |
| 47 | Plugins |
| 48 | |
| 49 | * [Backdrop CMS][backdrop-cms] - [backdrop-select2] |
| 50 | * [Django] |
| 51 | - [django-autocomplete-light] |
| 52 | - [django-easy-select2] |
| 53 | - [django-select2] |
| 54 | * [Drupal] - [drupal-select2] |
| 55 | * [Meteor] - [meteor-select2] |
| 56 | * [Ruby on Rails][ruby-on-rails] - [select2-rails] |
| 57 | * [Wicket] - [wicketstuff-select2] |
| 58 | * [Yii 2][yii2] - [yii2-widget-select2] |
| 59 | * [Angularjs][angularjs] - [mdr-angular-select2] |
| 60 | |
| 61 | Themes |
| 62 | |
| 63 | - [Bootstrap 3][bootstrap3] - [select2-bootstrap-theme] |
| 64 | - [Bootstrap 4][bootstrap4] - [select2-bootstrap4-theme] |
| 65 | - [](https://getbootstrap.com/docs/5.0Bootstrap 5](https://getbootstrap.com/docs/5.0](https://getbootstrap.com/docs/5.0) - [](https://github.com/apalfrey/select2-bootstrap-5-themeselect2-bootstrap-5-theme](https://github.com/apalfrey/select2-bootstrap-5-theme](https://github.com/apalfrey/select2-bootstrap-5-theme) |
| 66 | - [Flat UI][flat-ui] - [select2-flat-theme] |
| 67 | |
| 68 | Missing an integration? Modify this `README` and make a pull request back here to Select2 on GitHub. |
| 69 | |
| 70 | Internationalization (i18n) |
| 71 | --------------------------- |
| 72 | Select2 supports multiple languages by simply including the right language JS |
| 73 | file (`dist/js/i18n/it.js`, `dist/js/i18n/nl.js`, etc.) after |
| 74 | `dist/js/select2.js`. |
| 75 | |
| 76 | Missing a language? Just copy `src/js/select2/i18n/en.js`, translate it, and |
| 77 | make a pull request back to Select2 here on GitHub. |
| 78 | |
| 79 | Documentation |
| 80 | ------------- |
| 81 | The documentation for Select2 is available |
| 82 | [online at the documentation website][documentation] and is located within the |
| 83 | [`docs` directory of this repository][documentation-directory]. |
| 84 | |
| 85 | Community |
| 86 | --------- |
| 87 | You can find out about the different ways to get in touch with the Select2 |
| 88 | community at the [Select2 community page][community]. |
| 89 | |
| 90 | Copyright and license |
| 91 | --------------------- |
| 92 | The license is available within the repository in the [LICENSE][license] file. |
| 93 | |
| 94 | Contributors |
| 95 | ------------ |
| 96 | |
| 97 | ### Code Contributors |
| 98 | |
| 99 | This project exists thanks to all the people who contribute. [[](.github/CONTRIBUTING.mdContribute](.github/CONTRIBUTING.md](.github/CONTRIBUTING.md)]. |
| 100 | <a href="https://github.com/select2/select2/graphs/contributors"><img src="https://opencollective.com/select2/contributors.svg?width=890&button=false" /></a> |
| 101 | |
| 102 | ### Financial Contributors |
| 103 | |
| 104 | Become a financial contributor and help us sustain our community. [[](https://opencollective.com/select2/contributeContribute](https://opencollective.com/select2/contribute](https://opencollective.com/select2/contribute)] |
| 105 | |
| 106 | #### Individuals |
| 107 | |
| 108 | <a href="https://opencollective.com/select2"><img src="https://opencollective.com/select2/individuals.svg?width=890"></a> |
| 109 | |
| 110 | #### Organizations |
| 111 | |
| 112 | Support this project with your organization. Your logo will show up here with a link to your website. [[](https://opencollective.com/select2/contributeContribute](https://opencollective.com/select2/contribute](https://opencollective.com/select2/contribute)] |
| 113 | |
| 114 | <a href="https://opencollective.com/select2/organization/0/website"><img src="https://opencollective.com/select2/organization/0/avatar.svg"></a> |
| 115 | <a href="https://opencollective.com/select2/organization/1/website"><img src="https://opencollective.com/select2/organization/1/avatar.svg"></a> |
| 116 | <a href="https://opencollective.com/select2/organization/2/website"><img src="https://opencollective.com/select2/organization/2/avatar.svg"></a> |
| 117 | <a href="https://opencollective.com/select2/organization/3/website"><img src="https://opencollective.com/select2/organization/3/avatar.svg"></a> |
| 118 | <a href="https://opencollective.com/select2/organization/4/website"><img src="https://opencollective.com/select2/organization/4/avatar.svg"></a> |
| 119 | <a href="https://opencollective.com/select2/organization/5/website"><img src="https://opencollective.com/select2/organization/5/avatar.svg"></a> |
| 120 | <a href="https://opencollective.com/select2/organization/6/website"><img src="https://opencollective.com/select2/organization/6/avatar.svg"></a> |
| 121 | <a href="https://opencollective.com/select2/organization/7/website"><img src="https://opencollective.com/select2/organization/7/avatar.svg"></a> |
| 122 | <a href="https://opencollective.com/select2/organization/8/website"><img src="https://opencollective.com/select2/organization/8/avatar.svg"></a> |
| 123 | <a href="https://opencollective.com/select2/organization/9/website"><img src="https://opencollective.com/select2/organization/9/avatar.svg"></a> |
| 124 | |
| 125 | |
| 126 | [cdnjs]: http://www.cdnjs.com/libraries/select2 |
| 127 | [community]: https://select2.org/getting-help |
| 128 | [documentation]: https://select2.org |
| 129 | [documentation-directory]: https://github.com/select2/select2/tree/develop/docs |
| 130 | [freenode]: https://freenode.net/ |
| 131 | [github-actions-image]: https://github.com/select2/select2/workflows/CI/badge.svg |
| 132 | [jsdelivr]: https://www.jsdelivr.com/package/npm/select2 |
| 133 | [license]: LICENSE.md |
| 134 | [releases]: https://github.com/select2/select2/releases |
| 135 | |
| 136 | [angularjs]: https://angularjs.org/ |
| 137 | [backdrop-cms]: https://backdropcms.org/ |
| 138 | [backdrop-select2]: https://backdropcms.org/project/select2 |
| 139 | [bootstrap3]: https://getbootstrap.com/ |
| 140 | [bootstrap4]: https://getbootstrap.com/ |
| 141 | [django]: https://www.djangoproject.com/ |
| 142 | [django-autocomplete-light]: https://github.com/yourlabs/django-autocomplete-light |
| 143 | [django-easy-select2]: https://github.com/asyncee/django-easy-select2 |
| 144 | [django-select2]: https://github.com/applegrew/django-select2 |
| 145 | [drupal]: https://www.drupal.org/ |
| 146 | [drupal-select2]: https://www.drupal.org/project/select2 |
| 147 | [flat-ui]: http://designmodo.github.io/Flat-UI/ |
| 148 | [mdr-angular-select2]: https://github.com/modulr/mdr-angular-select2 |
| 149 | [meteor]: https://www.meteor.com/ |
| 150 | [meteor-select2]: https://github.com/nate-strauser/meteor-select2 |
| 151 | [ruby-on-rails]: http://rubyonrails.org/ |
| 152 | [select2-bootstrap-theme]: https://github.com/select2/select2-bootstrap-theme |
| 153 | [select2-bootstrap4-theme]: https://github.com/ttskch/select2-bootstrap4-theme |
| 154 | [select2-flat-theme]: https://github.com/techhysahil/select2-Flat_Theme |
| 155 | [select2-rails]: https://github.com/argerim/select2-rails |
| 156 | [vue.js]: http://vuejs.org/ |
| 157 | [select2-vue]: http://vuejs.org/examples/select2.html |
| 158 | [wicket]: https://wicket.apache.org/ |
| 159 | [wicketstuff-select2]: https://github.com/wicketstuff/core/tree/master/select2-parent |
| 160 | [yii2]: http://www.yiiframework.com/ |
| 161 | [yii2-widget-select2]: https://github.com/kartik-v/yii2-widget-select2 |
| 162 |