/ui-select

AngularJS-native version of Select2 and Selectize

Primary LanguageJavaScriptMIT LicenseMIT

AngularJS ui-select Build Status

Gitter

AngularJS-native version of Select2 and Selectize.

Last Changes

Features

  • Search, Select, and Multi-select
  • Themes: Bootstrap, Select2 and Selectize
  • Keyboard support
  • jQuery not required (except for old browsers)
  • Small code base: 4.57KB min/gzipped vs 20KB for select2

For the roadmap, check issue #3 and the Wiki page.

Installation using Composer

Make sure composer is install globally before we proceed. After that we need to add below piece of code in composer.json file located inside your project root folder.

{
    "require": {
        "components/ui-select": "dev-master"
    }
}
  • Run composer update and composer will install the component.
  • Inside your HTML add below script and link tags.
    • select.js: <script src="components/ui-select/dist/select.min.js"></script>
    • select.css: <link rel="stylesheet" href="components/ui-select/dist/select.min.css">

Development

Prepare your environment

  • Install Node.js and NPM (should come with)
  • Install global dev dependencies: npm install -g bower gulp
  • Install local dev dependencies: npm install && bower install in repository directory

Development Commands

  • gulp to jshint, build and test
  • gulp build to jshint and build
  • gulp test for one-time test with karma (also build and jshint)
  • gulp watch to watch src files to jshint, build and test when changed

Contributing

When issuing a pull request, please exclude changes from the "dist" folder to avoid merge conflicts.