1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
# Select2 for rails asset pipeline
[Select2](https://github.com/select2/select2) is a jQuery based replacement for select boxes. It supports searching, remote data sets, and infinite scrolling of results.
The `select2-rails` gem integrates the `Select2` jQuery plugin with the Rails asset pipeline.
[](http://badge.fury.io/rb/select2-rails)
## Usage
### Install select2-rails gem
Add `select2-rails` to your Gemfile and run `bundle install`:
gem "select2-rails"
### Include select2-rails javascript assets
Add the following to your `app/assets/javascripts/application.js`:
//= require select2
To add `select2-full.js` instead of `select2.js`, add the following instead :
//= require select2-full
### Include select2-rails stylesheet assets
Add to your `app/assets/stylesheets/application.css`:
*= require select2
If you are using Twitter Boostrap you need to also require the bootstrap theme CSS in addition to the above require.
*= require select2-bootstrap
To apply the theme, tell Select2 to do so by passing `bootstrap` to the [`theme`](https://select2.github.io/examples.html#themes) option when initializing Select2:
$( "#dropdown" ).select2({
theme: "bootstrap"
});
## Internationalization (i18n)
The `select2-rails` now supports multiple languages.
Add the following to your `app/assets/javascripts/application.js`:
//= require select2_locale_"any possible language"
To apply the language, pass whatever language you'd like to use to the [`language`](https://select2.github.io/examples.html#language) option when initializing Select2:
$( "#dropdown" ).select2({
language: "zh-TW"
});
Possible languages:
af, ar, az, bg, bn, bs, ca, cs, da, de, dsb, el, en, es, et, eu, fa, fi, fr, gl, he, hi, hr, hsb, hu, hy, id, is, it, ja, ka, km, ko, lt, lv, mk, ms, nb, ne, nl, pl, ps, pt, pt-BR, ro, ru, sk, sl, sq, sr, sr-Cyrl, sv, th, tk, tr, uk, vi, zh-CN, zh-TW
## Example
Code [here](https://github.com/argerim/select_2_example)
Heroku app [here](http://select-2-example.herokuapp.com/)
## Fix
### IE8 Invalid Character
IE8 doesn't support some unescaped Unicode character and need to quote keys in object literals
You need some configurations for [Uglifier](https://github.com/lautis/uglifier) to do the work.
Add to your `config/environments/production.rb`
require 'uglifier'
config.assets.js_compressor = Uglifier.new(output: {ascii_only: true, quote_keys: true})
## Version
From `v2.1.0` on, `select2-rails`'s version will match the version of `Select2` it uses.
The last number of the version is the patch version specific to the gem. For example, for a version of the form `2.x.y`, `2.x` is the release of `Select2` we should be compatible with, and y is the patch version specific to the gem (ie. to resolve any gem-specific issues that crop up).
## Contributions
If you want to contribute, please:
* Fork the project.
* Make your feature addition or bug fix.
* Send me a pull request on Github.
## License
Selec2-Rails is released under the [MIT License](http://www.opensource.org/licenses/MIT).
|
