2012-03-04 22:58:26 +04:00
|
|
|
Select2
|
2013-06-05 08:34:54 +04:00
|
|
|
=======
|
2012-03-04 22:58:26 +04:00
|
|
|
|
2013-06-05 19:18:00 +04:00
|
|
|
Select2 is a jQuery-based replacement for select boxes. It supports searching, remote data sets, and infinite scrolling of results.
|
2012-03-04 22:58:26 +04:00
|
|
|
|
2013-06-05 19:18:00 +04:00
|
|
|
To get started, checkout examples and documentation at http://ivaynberg.github.com/select2
|
2012-03-04 22:58:26 +04:00
|
|
|
|
2013-06-05 08:34:54 +04:00
|
|
|
Use cases
|
|
|
|
|
---------
|
2012-06-07 20:33:22 +04:00
|
|
|
|
2013-06-05 19:18:00 +04:00
|
|
|
* 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 nested. 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.
|
2012-06-07 20:33:22 +04:00
|
|
|
|
2013-06-05 08:34:54 +04:00
|
|
|
Browser compatibility
|
|
|
|
|
---------------------
|
2013-05-14 19:52:42 +04:00
|
|
|
* IE 8+
|
2012-06-09 05:18:40 +04:00
|
|
|
* Chrome 8+
|
2013-05-14 19:52:42 +04:00
|
|
|
* Firefox 10+
|
2012-06-09 05:18:40 +04:00
|
|
|
* Safari 3+
|
|
|
|
|
* Opera 10.6+
|
|
|
|
|
|
2012-06-15 07:27:10 +04:00
|
|
|
Integrations
|
|
|
|
|
------------
|
2012-06-15 05:08:49 +04:00
|
|
|
|
2013-03-19 19:53:36 +04:00
|
|
|
* [Wicket-Select2](https://github.com/ivaynberg/wicket-select2) (Java / [Apache Wicket](http://wicket.apache.org))
|
2012-06-15 07:27:10 +04:00
|
|
|
* [select2-rails](https://github.com/argerim/select2-rails) (Ruby on Rails)
|
2012-06-27 05:16:57 +04:00
|
|
|
* [AngularUI](http://angular-ui.github.com/#directives-select2) ([AngularJS](angularjs.org))
|
2012-08-12 19:38:04 +04:00
|
|
|
* [Django](https://github.com/applegrew/django-select2)
|
2013-03-12 11:05:18 +04:00
|
|
|
* [Symfony](https://github.com/19Gerhard85/sfSelect2WidgetsPlugin)
|
2014-01-02 20:52:26 +04:00
|
|
|
* [Symfony2](https://github.com/avocode/FormExtensions)
|
2014-04-15 01:39:49 +04:00
|
|
|
* [Bootstrap 2](https://github.com/t0m/select2-bootstrap-css) and [Bootstrap 3](https://github.com/t0m/select2-bootstrap-css/tree/bootstrap3) (CSS skins)
|
|
|
|
|
* [Meteor](https://github.com/nate-strauser/meteor-select2) (modern reactive JavaScript framework; + [Bootstrap 3 skin](https://github.com/esperadomedia/meteor-select2-bootstrap3-css/))
|
2013-03-27 20:00:19 +04:00
|
|
|
* [Yii](https://github.com/tonybolzan/yii-select2)
|
2012-06-15 05:08:49 +04:00
|
|
|
|
2013-03-13 20:59:59 +04:00
|
|
|
Internationalization (i18n)
|
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
|
|
Select2 supports multiple languages by simply including the right
|
2013-06-05 19:18:00 +04:00
|
|
|
language JS file (`select2_locale_it.js`, `select2_locale_nl.js`, etc.).
|
2013-03-13 20:59:59 +04:00
|
|
|
|
|
|
|
|
Missing a language? Just copy `select2_locale_en.js.template`, translate
|
2013-06-05 19:18:00 +04:00
|
|
|
it, and make a pull request back to Select2 here on GitHub.
|
2013-03-13 20:59:59 +04:00
|
|
|
|
2012-03-04 22:58:26 +04:00
|
|
|
Bug tracker
|
|
|
|
|
-----------
|
|
|
|
|
|
|
|
|
|
Have a bug? Please create an issue here on GitHub!
|
|
|
|
|
|
2012-03-04 22:59:28 +04:00
|
|
|
https://github.com/ivaynberg/select2/issues
|
2012-03-04 22:58:26 +04:00
|
|
|
|
|
|
|
|
Mailing list
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
Have a question? Ask on our mailing list!
|
|
|
|
|
|
2012-03-04 22:59:28 +04:00
|
|
|
select2@googlegroups.com
|
2012-03-04 22:58:26 +04:00
|
|
|
|
2012-03-04 22:59:28 +04:00
|
|
|
https://groups.google.com/d/forum/select2
|
2012-03-04 22:58:26 +04:00
|
|
|
|
|
|
|
|
|
2013-06-05 08:34:54 +04:00
|
|
|
Copyright and license
|
2012-03-04 22:58:26 +04:00
|
|
|
---------------------
|
|
|
|
|
|
2012-05-03 20:01:13 +04:00
|
|
|
Copyright 2012 Igor Vaynberg
|
2012-03-04 22:58:26 +04:00
|
|
|
|
2013-06-05 19:14:41 +04:00
|
|
|
This software is licensed under the Apache License, Version 2.0 (the "Apache License") or the GNU
|
|
|
|
|
General Public License version 2 (the "GPL License"). You may choose either license to govern your
|
|
|
|
|
use of this software only upon the condition that you accept all of the terms of either the Apache
|
|
|
|
|
License or the GPL License.
|
2012-10-03 22:34:49 +04:00
|
|
|
|
|
|
|
|
You may obtain a copy of the Apache License and the GPL License in the LICENSE file, or at:
|
2012-03-04 22:58:26 +04:00
|
|
|
|
2012-05-03 20:01:13 +04:00
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
2012-10-03 22:34:49 +04:00
|
|
|
http://www.gnu.org/licenses/gpl-2.0.html
|
2012-05-03 20:01:13 +04:00
|
|
|
|
2013-06-05 19:14:41 +04:00
|
|
|
Unless required by applicable law or agreed to in writing, software distributed under the Apache License
|
|
|
|
|
or the GPL License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
|
|
|
|
|
either express or implied. See the Apache License and the GPL License for the specific language governing
|
2013-03-12 11:05:18 +04:00
|
|
|
permissions and limitations under the Apache License and the GPL License.
|
