i18n
5 days ago
LICENSE
5 days ago
README.md
5 days ago
bower.json
5 days ago
component.json
5 days ago
composer.json
5 days ago
index.html
5 days ago
package.json
5 days ago
release.sh
5 days ago
select2-bootstrap.css
5 days ago
select2-spinner.gif
5 days ago
select2.css
5 days ago
select2.jquery.json
5 days ago
select2.min.js
5 days ago
select2.png
5 days ago
select2_locale_en.js.template
5 days ago
select2x2.png
5 days ago
README.md
103 lines
| 1 | Select2 |
| 2 | ======= |
| 3 | |
| 4 | Select2 is a jQuery-based replacement for select boxes. It supports searching, remote data sets, and infinite scrolling of results. |
| 5 | |
| 6 | To get started, checkout examples and documentation at http://ivaynberg.github.com/select2 |
| 7 | |
| 8 | Use cases |
| 9 | --------- |
| 10 | |
| 11 | * Enhancing native selects with search. |
| 12 | * Enhancing native selects with a better multi-select interface. |
| 13 | * Loading data from JavaScript: easily load items via ajax and have them searchable. |
| 14 | * Nesting optgroups: native selects only support one level of nested. Select2 does not have this restriction. |
| 15 | * Tagging: ability to add new items on the fly. |
| 16 | * Working with large, remote datasets: ability to partially load a dataset based on the search term. |
| 17 | * Paging of large datasets: easy support for loading more pages when the results are scrolled to the end. |
| 18 | * Templating: support for custom rendering of results and selections. |
| 19 | |
| 20 | Browser compatibility |
| 21 | --------------------- |
| 22 | * IE 8+ |
| 23 | * Chrome 8+ |
| 24 | * Firefox 10+ |
| 25 | * Safari 3+ |
| 26 | * Opera 10.6+ |
| 27 | |
| 28 | Usage |
| 29 | ----- |
| 30 | You can source Select2 directly from a [](http://www.jsdelivr.com/#!select2CDN like JSDliver](http://www.jsdelivr.com/#!select2](http://www.jsdelivr.com/#!select2), [](https://github.com/ivaynberg/select2/tagsdownload it from this GitHub repo](https://github.com/ivaynberg/select2/tags](https://github.com/ivaynberg/select2/tags), or use one of the integrations below. |
| 31 | |
| 32 | Integrations |
| 33 | ------------ |
| 34 | |
| 35 | * [](https://github.com/ivaynberg/wicket-select2Wicket-Select2](https://github.com/ivaynberg/wicket-select2](https://github.com/ivaynberg/wicket-select2) (Java / [](http://wicket.apache.orgApache Wicket](http://wicket.apache.org](http://wicket.apache.org)) |
| 36 | * [](https://github.com/argerim/select2-railsselect2-rails](https://github.com/argerim/select2-rails](https://github.com/argerim/select2-rails) (Ruby on Rails) |
| 37 | * [](http://angular-ui.github.com/#directives-select2AngularUI](http://angular-ui.github.com/#directives-select2](http://angular-ui.github.com/#directives-select2) ([](angularjs.orgAngularJS](angularjs.org](angularjs.org)) |
| 38 | * [](https://github.com/applegrew/django-select2Django](https://github.com/applegrew/django-select2](https://github.com/applegrew/django-select2) |
| 39 | * [](https://github.com/19Gerhard85/sfSelect2WidgetsPluginSymfony](https://github.com/19Gerhard85/sfSelect2WidgetsPlugin](https://github.com/19Gerhard85/sfSelect2WidgetsPlugin) |
| 40 | * [](https://github.com/avocode/FormExtensionsSymfony2](https://github.com/avocode/FormExtensions](https://github.com/avocode/FormExtensions) |
| 41 | * [](https://github.com/t0m/select2-bootstrap-cssBootstrap 2](https://github.com/t0m/select2-bootstrap-css](https://github.com/t0m/select2-bootstrap-css) and [](https://github.com/t0m/select2-bootstrap-css/tree/bootstrap3Bootstrap 3](https://github.com/t0m/select2-bootstrap-css/tree/bootstrap3](https://github.com/t0m/select2-bootstrap-css/tree/bootstrap3) (CSS skins) |
| 42 | * [](https://github.com/nate-strauser/meteor-select2Meteor](https://github.com/nate-strauser/meteor-select2](https://github.com/nate-strauser/meteor-select2) (modern reactive JavaScript framework; + [](https://github.com/esperadomedia/meteor-select2-bootstrap3-css/Bootstrap 3 skin](https://github.com/esperadomedia/meteor-select2-bootstrap3-css/](https://github.com/esperadomedia/meteor-select2-bootstrap3-css/)) |
| 43 | * [](https://jquery-select2.meteor.comMeteor](https://jquery-select2.meteor.com](https://jquery-select2.meteor.com) |
| 44 | * [](http://demos.krajee.com/widgets#select2Yii 2.x](http://demos.krajee.com/widgets#select2](http://demos.krajee.com/widgets#select2) |
| 45 | * [](https://github.com/tonybolzan/yii-select2Yii 1.x](https://github.com/tonybolzan/yii-select2](https://github.com/tonybolzan/yii-select2) |
| 46 | * [](https://atmospherejs.com/package/jquery-select2AtmosphereJS](https://atmospherejs.com/package/jquery-select2](https://atmospherejs.com/package/jquery-select2) |
| 47 | |
| 48 | ### Example Integrations |
| 49 | |
| 50 | * [](https://github.com/ivaynberg/select2/wiki/Knockout.js-IntegrationKnockout.js](https://github.com/ivaynberg/select2/wiki/Knockout.js-Integration](https://github.com/ivaynberg/select2/wiki/Knockout.js-Integration) |
| 51 | * [](https://github.com/ivaynberg/select2/wiki/Socket.IO-IntegrationSocket.IO](https://github.com/ivaynberg/select2/wiki/Socket.IO-Integration](https://github.com/ivaynberg/select2/wiki/Socket.IO-Integration) |
| 52 | * [](https://github.com/ivaynberg/select2/wiki/PHP-ExamplePHP](https://github.com/ivaynberg/select2/wiki/PHP-Example](https://github.com/ivaynberg/select2/wiki/PHP-Example) |
| 53 | * [.Net MVC] (https://github.com/ivaynberg/select2/wiki/.Net-MVC-Example) |
| 54 | |
| 55 | Internationalization (i18n) |
| 56 | --------------------------- |
| 57 | |
| 58 | Select2 supports multiple languages by simply including the right language JS |
| 59 | file (`select2_locale_it.js`, `select2_locale_nl.js`, etc.) after `select2.js`. |
| 60 | |
| 61 | Looking for a specific language? Just check if it is already available from here: |
| 62 | https://github.com/ericevenchick/trainstats/tree/master/web/select2-3.5.4 |
| 63 | |
| 64 | Missing a language? Just copy `select2_locale_en.js.template`, translate |
| 65 | it, and make a pull request back to Select2 here on GitHub. |
| 66 | |
| 67 | Bug tracker |
| 68 | ----------- |
| 69 | |
| 70 | Have a bug? Please create an issue here on GitHub! |
| 71 | |
| 72 | https://github.com/ivaynberg/select2/issues |
| 73 | |
| 74 | Mailing list |
| 75 | ------------ |
| 76 | |
| 77 | Have a question? Ask on our mailing list! |
| 78 | |
| 79 | select2@googlegroups.com |
| 80 | |
| 81 | https://groups.google.com/d/forum/select2 |
| 82 | |
| 83 | |
| 84 | Copyright and license |
| 85 | --------------------- |
| 86 | |
| 87 | Copyright 2012 Igor Vaynberg |
| 88 | |
| 89 | This software is licensed under the Apache License, Version 2.0 (the "Apache License") or the GNU |
| 90 | General Public License version 2 (the "GPL License"). You may choose either license to govern your |
| 91 | use of this software only upon the condition that you accept all of the terms of either the Apache |
| 92 | License or the GPL License. |
| 93 | |
| 94 | You may obtain a copy of the Apache License and the GPL License in the LICENSE file, or at: |
| 95 | |
| 96 | http://www.apache.org/licenses/LICENSE-2.0 |
| 97 | http://www.gnu.org/licenses/gpl-2.0.html |
| 98 | |
| 99 | Unless required by applicable law or agreed to in writing, software distributed under the Apache License |
| 100 | or the GPL License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, |
| 101 | either express or implied. See the Apache License and the GPL License for the specific language governing |
| 102 | permissions and limitations under the Apache License and the GPL License. |
| 103 |