Angular Select2

Angular Select2 is an Angularjs component that can replacement for select boxes.

Features

• Uses the native Angularjs scope for data binding
• Fast and lightweight
• Remote and local data support
• Big data support

Requirements

• Angularjs
• Bootstrap 3.
• Selec2.

Quick start

Several quick start options are available:

• Download the latest release
• Clone the repo: git clone https://github.com/Modulr/mdr-angular-select2.git.
• Install with Bower: bower install mdr-angular-select2.
• Install with npm: npm install mdr-angular-select2.

What's included

mdr-angular-select2/
  dist/
    ├── mdr-select2.js
    └── mdr-select2.min.js

Documentation

Usage

Load JS

<script href="mdr-angular-select2/dist/mdr-select2.min.js"></script>

Code

angular.module('MyApp', ['mdr.select2'])

HTML View or Templates

Basic Directive

<mdr-select2 url="http://miserver.com/json" options="item.estate for item in collection track by item.id"></mdr-select2>

Complete Directive (All attributes)

<mdr-select2 src="collection" options="item.estate group by item.zone for item in collection | orderBy:'item' track by item.id" model="model" selected="value" placeholder="Seleccionar" allow-clear="true" disabled="true" required="true"></mdr-select2>

API

Attributes

Attribute	Type	Description
url	string	Is the path where you get list of items.
src	array	Collection of objects.
options	string	Dynamically generate a list of elements.
model	object	Get model selected (Output).
selected	object	Set select value by track (Input).
allow-clear	boolean	If required clear selection the component is marked as true.
placeholder	string	Text into placeholder.
disabled	boolean	If required disable the component is marked as true.
required	boolean	If is required the component is marked as true.

How to contribute

All contributions are very welcome, We love it. There are several ways to help out:

• Create an issue on GitHub, if you have found a bug
• Write test cases for open bug issues
• Write patches for open bug/feature issues, preferably with test cases included
• Contribute to the documentation

There are a few guidelines that we need contributors to follow so that we have a chance of keeping on top of things.

If you want to making changes Better avoid working directly on the master branch, to avoid conflicts if you pull in updates from origin, so, if make your contribution under the branch dev, into folder src/.

Community

• Implementation help may be found at Stack Overflow (tagged mdr-select2).

Creators

@AlfredoBarronC

Copyright and license

Code and documentation (c) Copyright 2015 Modulr. Code published under license MIT