ui-select2 
==========
This directive allows you to enhance your select elements with behaviour from the select2 library.

Requirements

- AngularJS
- JQuery
- Select2

Setup

1. Install Karma, Grunt and Bower
$ npm install -g karma grunt-cli bower
2. Install development dependencies
$ npm install
3. Install components
$ bower install
4. ???
5. Profit!

Testing

We use Grunt to check for JavaScript syntax errors and execute all unit tests. To run Grunt, simply execute:

$ grunt

This will lint and test the code, then exit. To have Grunt stay open and automatically lint and test your files whenever you make a code change, use:

$ grunt karma:server watch

This will start a Karma server in the background and run unit tests in Firefox and PhantomJS whenever the source code or spec file is saved.

Usage

We use bower for dependency management. Install AngularUI Select2 into your project by running the command

$ bower install angular-ui-select2

If you use a bower.json file in your project, you can have Bower save ui-select2 as a dependency by passing the --save or --save-dev flag with the above command.

This will copy the ui-select2 files into your bower_components folder, along with its dependencies. Load the script files in your application:
``html





`

(Note that jquery must be loaded before angular so that it doesn't use jqLite internally)


Add the select2 module as a dependency to your application module:

`javascript
var myAppModule = angular.module('MyApp', ['ui.select2']);
`

Apply the directive to your form elements:

`html


First
Second
Third

`

Options

All the select2 options can be passed through the directive. You can read more about the supported list of options and what they do on the Select2 Documentation Page

`javascript
myAppModule.controller('MyController', function($scope) {
$scope.select2Options = {
allowClear:true
};
});
`

`html

First
Second
Third

`

Some times it may make sense to specify the options in the template file.

`html

First
Second
Third

`

To define global defaults, you can configure the uiSelect2Config injectable:

`javascript
myAppModule.run(['uiSelect2Config', function(uiSelect2Config) {
uiSelect2Config.placeholder = "Placeholder text";
}]);
`

Working with ng-model

The ui-select2 directive plays nicely with ng-model and validation directives such as ng-required.

If you add the ng-model directive to same the element as ui-select2 then the picked option is automatically synchronized with the model value.

Working with dynamic options


ui-select2 is incompatible with . For the best results use instead.
`html


{{number.text}}

`

Working with placeholder text

In order to properly support the Select2 placeholder, create an empty tag at the top of the and either set a data-placeholder on the select element or pass a placeholder option to Select2.
`html


First
Second
Third

`

ng-required directive

If you apply the required directive to element then the form element is invalid until an option is selected.

Note: Remember that the ng-required directive must be explicitly set, i.e. to "true". This is especially true on divs:

`html


First
Second
Third

`

Using simple tagging mode

When AngularJS View-Model tags are stored as a list of strings, setting
the ui-select2 specific option simple_tags will allow to keep the model
as a list of strings, and not convert it into a list of Select2 tag objects.

`html
type="hidden"
ui-select2="select2Options"
ng-model="list_of_string"
>
`

`javascript
myAppModule.controller('MyController', function($scope) {
$scope.list_of_string = ['tag1', 'tag2']
$scope.select2Options = {
'multiple': true,
'simple_tags': true,
'tags': ['tag1', 'tag2', 'tag3', 'tag4'] // Can be empty list.
};
});
``