83 lines
3.1 KiB
Markdown
83 lines
3.1 KiB
Markdown
|
Select2
|
||
|
|
=================
|
||
|
|
|
||
|
|
Select2 is a jQuery based replacement for select boxes. It supports searching, remote data sets, and infinite scrolling of results.
|
||
|
|
|
||
|
|
To get started checkout examples and documentation at http://ivaynberg.github.com/select2
|
||
|
|
|
||
|
|
What Usecases Does Select2 Support
|
||
|
|
-------------------------------------------------
|
||
|
|
|
||
|
|
* Enhances native selects with search
|
||
|
|
* Enhances native selects with a better multi-select interface
|
||
|
|
* Loading data from javascript: easily load items via ajax and have them searchable
|
||
|
|
* Nested 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 datesets: 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+ (7 mostly works except for [issue with z-index](https://github.com/ivaynberg/select2/issues/37))
|
||
|
|
* Chrome 8+
|
||
|
|
* Firefox 3.5+
|
||
|
|
* Safari 3+
|
||
|
|
* Opera 10.6+
|
||
|
|
|
||
|
|
Integrations
|
||
|
|
------------
|
||
|
|
|
||
|
|
* [Wicket-Select2](https://github.com/ivaynberg/wicket-select2) (Java / [Apache Wicket](http://wicket.apache.org))
|
||
|
|
* [select2-rails](https://github.com/argerim/select2-rails) (Ruby on Rails)
|
||
|
|
* [AngularUI](http://angular-ui.github.com/#directives-select2) ([AngularJS](angularjs.org))
|
||
|
|
* [Django](https://github.com/applegrew/django-select2)
|
||
|
|
* [Symfony](https://github.com/19Gerhard85/sfSelect2WidgetsPlugin)
|
||
|
|
* [Bootstrap](https://github.com/t0m/select2-bootstrap-css) (CSS skin)
|
||
|
|
|
||
|
|
Internationalization (i18n)
|
||
|
|
---------------------------
|
||
|
|
|
||
|
|
Select2 supports multiple languages by simply including the right
|
||
|
|
language JS file (`select2_locale_it.js`, `select2_locale_nl.js` etc.).
|
||
|
|
|
||
|
|
Missing a language? Just copy `select2_locale_en.js.template`, translate
|
||
|
|
it and make a pull request back to Select2 here on Github.
|
||
|
|
|
||
|
|
Bug tracker
|
||
|
|
-----------
|
||
|
|
|
||
|
|
Have a bug? Please create an issue here on GitHub!
|
||
|
|
|
||
|
|
https://github.com/ivaynberg/select2/issues
|
||
|
|
|
||
|
|
Mailing list
|
||
|
|
------------
|
||
|
|
|
||
|
|
Have a question? Ask on our mailing list!
|
||
|
|
|
||
|
|
select2@googlegroups.com
|
||
|
|
|
||
|
|
https://groups.google.com/d/forum/select2
|
||
|
|
|
||
|
|
|
||
|
|
Copyright and License
|
||
|
|
---------------------
|
||
|
|
|
||
|
|
Copyright 2012 Igor Vaynberg
|
||
|
|
|
||
|
|
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.
|
||
|
|
|
||
|
|
You may obtain a copy of the Apache License and the GPL License in the LICENSE file, or at:
|
||
|
|
|
||
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
||
|
|
http://www.gnu.org/licenses/gpl-2.0.html
|
||
|
|
|
||
|
|
Unless required by applicable law or agreed to in writing, software distributed under the Apache License
|
||
|
|
or the GPL Licesnse 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
|
||
|
|
permissions and limitations under the Apache License and the GPL License.
|