Merge branch 'master' into select2-ng
This adds the package management files back into the repository and also updates the README to reflect the future Select2 4.0.
This commit is contained in:
Kevin Brown
commit
fef1ccfd81
146
README.md
Normal file
146
README.md
Normal file
@ -0,0 +1,146 @@
|
|||||||
|
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
|
||||||
|
|
||||||
|
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 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.
|
||||||
|
|
||||||
|
Browser compatibility
|
||||||
|
---------------------
|
||||||
|
* IE 8+
|
||||||
|
* Chrome 8+
|
||||||
|
* Firefox 10+
|
||||||
|
* Safari 3+
|
||||||
|
* Opera 10.6+
|
||||||
|
|
||||||
|
Usage
|
||||||
|
-----
|
||||||
|
You can source Select2 directly from a CDN like [JSDliver][jsdelivr] or
|
||||||
|
[CDNJS][cdnjs], [download it from this GitHub repo][tags], or use one of
|
||||||
|
the integrations below.
|
||||||
|
|
||||||
|
Integrations
|
||||||
|
------------
|
||||||
|
|
||||||
|
* [Wicket-Select2][wicket-select2] (Java / [Apache Wicket][wicket])
|
||||||
|
* [select2-rails][select2-rails] (Ruby on Rails)
|
||||||
|
* [AngularUI][angularui-select] ([AngularJS][angularjs])
|
||||||
|
* [Django][django-select2]
|
||||||
|
* [Symfony][symfony-select2]
|
||||||
|
* [Symfony2][symfony2-select2]
|
||||||
|
* [Bootstrap 2][bootstrap2-select2] and [Bootstrap 3][bootstrap3-select2]
|
||||||
|
(CSS skins)
|
||||||
|
* [Meteor][meteor-select2] ([Bootstrap 3 skin][meteor-select2-bootstrap3])
|
||||||
|
* [Meteor][meteor-select2-alt]
|
||||||
|
* [Yii 2.x][yii2-select2]
|
||||||
|
* [Yii 1.x][yii-select2]
|
||||||
|
* [AtmosphereJS][atomospherejs-select2]
|
||||||
|
|
||||||
|
### Example Integrations
|
||||||
|
|
||||||
|
* [Knockout.js](https://github.com/ivaynberg/select2/wiki/Knockout.js-Integration)
|
||||||
|
* [Socket.IO](https://github.com/ivaynberg/select2/wiki/Socket.IO-Integration)
|
||||||
|
* [PHP](https://github.com/ivaynberg/select2/wiki/PHP-Example)
|
||||||
|
* [.Net MVC] (https://github.com/ivaynberg/select2/wiki/.Net-MVC-Example)
|
||||||
|
|
||||||
|
Internationalization (i18n)
|
||||||
|
---------------------------
|
||||||
|
|
||||||
|
Select2 supports multiple languages by simply including the right language JS
|
||||||
|
file (`select2_locale_it.js`, `select2_locale_nl.js`, etc.) after `select2.js`.
|
||||||
|
|
||||||
|
Missing a language? Just copy `select2_locale_en.js.template`, translate
|
||||||
|
it, and make a pull request back to Select2 here on GitHub.
|
||||||
|
|
||||||
|
Documentation
|
||||||
|
-------------
|
||||||
|
|
||||||
|
The documentation for Select2 is available
|
||||||
|
[through GitHub Pages][documentation] and is located within this repository
|
||||||
|
in the [docs folder][documentation-folder].
|
||||||
|
|
||||||
|
Community
|
||||||
|
---------
|
||||||
|
|
||||||
|
### 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
|
||||||
|
|
||||||
|
### IRC channel
|
||||||
|
|
||||||
|
Need help implementing Select2 in your project? Ask in our IRC channel!
|
||||||
|
|
||||||
|
**Network:** [Freenode][freenode] (`chat.freenode.net`)
|
||||||
|
|
||||||
|
**Channel:** `#select2`
|
||||||
|
|
||||||
|
**Web access:** https://webchat.freenode.net/?channels=select2
|
||||||
|
|
||||||
|
Copyright and license
|
||||||
|
---------------------
|
||||||
|
The MIT License (MIT)
|
||||||
|
|
||||||
|
Copyright (c) 2012-2014 Kevin Brown, Igor Vaynberg, and Select2 contributors
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
in the Software without restriction, including without limitation the rights
|
||||||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||||
|
copies of the Software, and to permit persons to whom the Software is
|
||||||
|
furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in
|
||||||
|
all copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||||||
|
THE SOFTWARE.
|
||||||
|
|
||||||
|
[angularjs]: https://angularjs.org/
|
||||||
|
[angularui-select]: http://angular-ui.github.io/#ui-select
|
||||||
|
[atmospherejs-select2]: https://atmospherejs.com/package/jquery-select2
|
||||||
|
[bootstrap2-select2]: https://github.com/t0m/select2-bootstrap-css
|
||||||
|
[bootstrap3-select2]: https://github.com/t0m/select2-bootstrap-css/tree/bootstrap3
|
||||||
|
[cdnjs]: http://www.cdnjs.com/libraries/select2
|
||||||
|
[django-select2]: https://github.com/applegrew/django-select2
|
||||||
|
[documentation]: https://ivaynberg.github.io/select2/
|
||||||
|
[documentation-folder]: https://github.com/ivaynberg/select2/tree/master/docs
|
||||||
|
[freenode]: https://freenode.net/
|
||||||
|
[jsdelivr]: http://www.jsdelivr.com/#!select2
|
||||||
|
[meteor-select2]: https://github.com/nate-strauser/meteor-select2
|
||||||
|
[meteor-select2-alt]: https://jquery-select2.meteor.com
|
||||||
|
[meteor-select2-bootstrap3]: https://github.com/esperadomedia/meteor-select2-bootstrap3-css/
|
||||||
|
[select2-rails]: https://github.com/argerim/select2-rails
|
||||||
|
[symfony-select2]: https://github.com/19Gerhard85/sfSelect2WidgetsPlugin
|
||||||
|
[symfony2-select2]: https://github.com/avocode/FormExtensions
|
||||||
|
[tags]: https://github.com/ivaynberg/select2/tags
|
||||||
|
[wicket]: http://wicket.apache.org
|
||||||
|
[wicket-select2]: https://github.com/ivaynberg/wicket-select2
|
||||||
|
[yii-select2]: https://github.com/tonybolzan/yii-select2
|
||||||
|
[yii2-select2]: http://demos.krajee.com/widgets#select2
|
||||||
8
bower.json
Normal file
8
bower.json
Normal file
@ -0,0 +1,8 @@
|
|||||||
|
{
|
||||||
|
"name": "select2",
|
||||||
|
"version": "3.5.2",
|
||||||
|
"main": ["select2.js", "select2.css", "select2.png", "select2x2.png", "select2-spinner.gif"],
|
||||||
|
"dependencies": {
|
||||||
|
"jquery": ">= 1.7.1"
|
||||||
|
}
|
||||||
|
}
|
||||||
66
component.json
Normal file
66
component.json
Normal file
@ -0,0 +1,66 @@
|
|||||||
|
{
|
||||||
|
"name": "select2",
|
||||||
|
"repo": "ivaynberg/select2",
|
||||||
|
"description": "Select2 is a jQuery based replacement for select boxes. It supports searching, remote data sets, and infinite scrolling of results.",
|
||||||
|
"version": "3.5.2",
|
||||||
|
"demo": "http://ivaynberg.github.io/select2/",
|
||||||
|
"keywords": [
|
||||||
|
"jquery"
|
||||||
|
],
|
||||||
|
"main": "select2.js",
|
||||||
|
"styles": [
|
||||||
|
"select2.css",
|
||||||
|
"select2-bootstrap.css"
|
||||||
|
],
|
||||||
|
"scripts": [
|
||||||
|
"select2.js",
|
||||||
|
"select2_locale_ar.js",
|
||||||
|
"select2_locale_bg.js",
|
||||||
|
"select2_locale_ca.js",
|
||||||
|
"select2_locale_cs.js",
|
||||||
|
"select2_locale_da.js",
|
||||||
|
"select2_locale_de.js",
|
||||||
|
"select2_locale_el.js",
|
||||||
|
"select2_locale_es.js",
|
||||||
|
"select2_locale_et.js",
|
||||||
|
"select2_locale_eu.js",
|
||||||
|
"select2_locale_fa.js",
|
||||||
|
"select2_locale_fi.js",
|
||||||
|
"select2_locale_fr.js",
|
||||||
|
"select2_locale_gl.js",
|
||||||
|
"select2_locale_he.js",
|
||||||
|
"select2_locale_hr.js",
|
||||||
|
"select2_locale_hu.js",
|
||||||
|
"select2_locale_id.js",
|
||||||
|
"select2_locale_is.js",
|
||||||
|
"select2_locale_it.js",
|
||||||
|
"select2_locale_ja.js",
|
||||||
|
"select2_locale_ka.js",
|
||||||
|
"select2_locale_ko.js",
|
||||||
|
"select2_locale_lt.js",
|
||||||
|
"select2_locale_lv.js",
|
||||||
|
"select2_locale_mk.js",
|
||||||
|
"select2_locale_ms.js",
|
||||||
|
"select2_locale_nl.js",
|
||||||
|
"select2_locale_no.js",
|
||||||
|
"select2_locale_pl.js",
|
||||||
|
"select2_locale_pt-BR.js",
|
||||||
|
"select2_locale_pt-PT.js",
|
||||||
|
"select2_locale_ro.js",
|
||||||
|
"select2_locale_ru.js",
|
||||||
|
"select2_locale_sk.js",
|
||||||
|
"select2_locale_sv.js",
|
||||||
|
"select2_locale_th.js",
|
||||||
|
"select2_locale_tr.js",
|
||||||
|
"select2_locale_uk.js",
|
||||||
|
"select2_locale_vi.js",
|
||||||
|
"select2_locale_zh-CN.js",
|
||||||
|
"select2_locale_zh-TW.js"
|
||||||
|
],
|
||||||
|
"images": [
|
||||||
|
"select2-spinner.gif",
|
||||||
|
"select2.png",
|
||||||
|
"select2x2.png"
|
||||||
|
],
|
||||||
|
"license": "MIT"
|
||||||
|
}
|
||||||
29
composer.json
Normal file
29
composer.json
Normal file
@ -0,0 +1,29 @@
|
|||||||
|
{
|
||||||
|
"name":
|
||||||
|
"ivaynberg/select2",
|
||||||
|
"description": "Select2 is a jQuery based replacement for select boxes.",
|
||||||
|
"version": "3.5.2",
|
||||||
|
"type": "component",
|
||||||
|
"homepage": "http://ivaynberg.github.io/select2/",
|
||||||
|
"license": "Apache-2.0",
|
||||||
|
"require": {
|
||||||
|
"robloach/component-installer": "*",
|
||||||
|
"components/jquery": ">=1.7.1"
|
||||||
|
},
|
||||||
|
"extra": {
|
||||||
|
"component": {
|
||||||
|
"scripts": [
|
||||||
|
"select2.js"
|
||||||
|
],
|
||||||
|
"files": [
|
||||||
|
"select2.js",
|
||||||
|
"select2_locale_*.js",
|
||||||
|
"select2.css",
|
||||||
|
"select2-bootstrap.css",
|
||||||
|
"select2-spinner.gif",
|
||||||
|
"select2.png",
|
||||||
|
"select2x2.png"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
36
select2.jquery.json
Normal file
36
select2.jquery.json
Normal file
@ -0,0 +1,36 @@
|
|||||||
|
{
|
||||||
|
"name": "select2",
|
||||||
|
"title": "Select2",
|
||||||
|
"description": "Select2 is a jQuery based replacement for select boxes. It supports searching, remote data sets, and infinite scrolling of results.",
|
||||||
|
"keywords": [
|
||||||
|
"select",
|
||||||
|
"autocomplete",
|
||||||
|
"typeahead",
|
||||||
|
"dropdown",
|
||||||
|
"multiselect",
|
||||||
|
"tag",
|
||||||
|
"tagging"
|
||||||
|
],
|
||||||
|
"version": "3.5.2",
|
||||||
|
"author": {
|
||||||
|
"name": "Igor Vaynberg",
|
||||||
|
"url": "https://github.com/ivaynberg"
|
||||||
|
},
|
||||||
|
"licenses": [
|
||||||
|
{
|
||||||
|
"type": "Apache",
|
||||||
|
"url": "http://www.apache.org/licenses/LICENSE-2.0"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "GPL v2",
|
||||||
|
"url": "http://www.gnu.org/licenses/gpl-2.0.html"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"bugs": "https://github.com/ivaynberg/select2/issues",
|
||||||
|
"homepage": "http://ivaynberg.github.com/select2",
|
||||||
|
"docs": "http://ivaynberg.github.com/select2/",
|
||||||
|
"download": "https://github.com/ivaynberg/select2/tags",
|
||||||
|
"dependencies": {
|
||||||
|
"jquery": ">=1.7.1"
|
||||||
|
}
|
||||||
|
}
|
||||||
Loading…
Reference in New Issue
Block a user