angular-autocomplete

Autocomplete directive works for you.

Module License: MIT

Added by: Sam Deering

GitHub

Repository

leftstick/angular-autocomplete

Stats

Stars: 2

Watchers: 2

Forks: 0

Author

Howard.Zuo
Howard.Zuo

Module Description

angular-autocomplete

Create autocomplete component within five minutes.

Try it: plunker

Requirement

UI dependency

Install

bower install angular-h-autocomplete --save

Basic Usage

  • Include hAuto.js into your index.html by using script tag, or you have other way to import dependency(For example: requirejs), like following:
<script type="text/javascript" src="[location]/hAuto.js"></script>
  • Add hAuto module as your angular app's dependency
var demo = angular.module('demo', ['hAuto']);
  • Use h-auto tag in your html
<div ng-controller="BasicController">
    <h-auto value="valueOne" init-items="data" item-select="onSelect(item, index)"></h-auto>
</div>
  • Writing BasicController
demo.controller('BasicController', ['$scope', function($scope) {
    $scope.data = ['Bhutan', 'Denmark', 'Japan', 'Bahrain', 'Tonga', 'Fang'];
    $scope.onSelect = function(item, index) {
        alert(item + ' is selected! and index is = ' + index);
    };
}]);

h-auto configuration

| Attribute | Type | Required | Description | | :------------- |:-------------| :-----:| :-----| | init-items | array(expression) | No | initialized search items. If you need a lazy-load mechanism depends on user's input, leave this option | | lazy-load(handler,searchTxt) | function(expression) | No | callback called after user stop typing for 1 sec, and you could fetch data from other place asynchronously and send back the data as search items to hAuto by calling handler(data), searchTxt is a string which user typed. see demo: Advanced lazy-loading| | item-select(item, index) | function(expression) | No | callback while you select one item from search result, and the item is the object/string you selected, and index is position of this item in this result. Note: item and index has to be defined in html, otherwise, you won't get them from controller | | value | string/object(expression) | No | the selected string/object will be stored in this expression, you can get selected item by calling $scope.[value] in your controller| | display-field | string | No | specify what property should be displayed in for each search result, only works if data from init-items or lazy-load is array of object, and display-field take higher priority than display-formatter. So if you set both those attribute in html, only display-field works | | display-formatter | function(expression) | No | a handler should be returned in this function, like demo: specify formatter for each item in search result. And the handler has the item as only one parameter. Only works if data from init-items or lazy-load is array of object | | on-submit | function(expression) | Yes | a function will be called while click the addon button |

run demo locally

Install npm dependency

npm install

Install bower dependency

bower install

run demo

gulp demo

LICENSE

MIT License

Module stats last updated: 2015-06-08 00:21:46

Disclaimer: Some data on this page may have been gathered from the authors GitHub respository. If you see any mistakes or outdated information please let us know. Thanks!