Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

ng-infinite-autocomplete

Package Overview
Dependencies
Maintainers
1
Versions
11
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

ng-infinite-autocomplete

AngularJS 1.x infinite-autocomplete wrapper

  • 2.0.5
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
23
decreased by-37.84%
Maintainers
1
Weekly downloads
 
Created
Source

Coverage Status

ng-inifinte-autocomplete

AngularJS 1.x Wrapper for infinite-autocomplete library

Note: Whenever I mention the CORE, then I'm targeting the infinite-autocomplete library

Install

via npm:

$ npm i --save ng-infinite-autocomplete

via bower:

$ bower i -S ng-infinite-autocomplete

Developer section

In the package.json scripts we've 4 basic tasks:

build - Build the code once

build:watch - Build the code and watch changes

test - Run tests once

test:watch - Run tests and watch changes

Usage Example

import * as angular from 'angular';
import 'ng-infinite-autocomplete';
//or <script src="bower_components/ng-infinite-autocomplete/dist/index.js"></script>

//inject infinite-autocomplete as dependency for myApp module
angular.module('myApp', ['infinite-autocomplete'])
...

Controller:

  angular.module('myApp')
   .controller('MainCtrl', ['$http', '$q', function($http, $q){
   vm.onSelectHandler = function($element, $data) {
      console.log(arguments);
   }
   
    vm.data = [
                { text: 'Islam Attrash', value: 1},
                { text: 'Shai Reznik', value: 2},
                { text: 'Uri Shaked', value: 3},
                { text: 'Salsabel Eawissat', value: 4}
            ];
    vm.getData = function($text, $page, $fetchSize) {
        var deferred = $q.defer();
        $http.get("http://localhost:5000/data?text="+ $text + "&page=" + $page + "&fetchSize=" + $fetchSize)
          .then(function(res) {
              deferred.resolve(res.data);
          });
        return deferred.promise;
    }
   });

Template:

<div ng-controller="MainCtrl as vm">
  <!-- For Static data -->
  <ng-infinite-autocomplete
    data="vm.data"
    on-select="vm.onSelectHandler($element, $data)"
  ></ng-infinite-autocomplete>

  <!-- For external API -->
  <ng-infinite-autocomplete
    fetch-size="8"
    get-data-from-api="vm.getData($text, $page, $fetchSize)"
  ></ng-infinite-autocomplete>
</div>

Live Demo (Default Style)

Override Implementations

See this section on CORE, you pass a class via customizedInput, customizedOptions attributes

Directive Inputs/Outputs

  /**
   * data static source
   */
  data?:Array<IOption>;
  /**
   * on-select event output handler when choosing an option
   */
  onSelect?:Function($element, $data);
  /**
   * max height for the options
   */
  maxHeight?:string;
  /**
   * data dynamic api source
   */
  getDataFromApi?($text:string, $page:number, $fetchSize:number):es6Promise<Array<any>>;
  /**
   * Chunk fetch size
   */
  fetchSize?:number,
  /**
   * Customized input class to override the default input
   */
  customizedInput?:IInputCompoenentConstructor;
  /**
   * Customized options class to override the default input
   */
  customizedOptions?:IOptionsComponentConstructor;
  /**
   * treat data source as immutable - To improve $watch process
   */
   immutable?

Restrictions regards Attributes

  • You must choose to pass data or getDataFromApi depends on whether the data is static or dynamic
  • data attribute must be an array of { text: 'some text', value: 1}, and value could be any type (number, string, object..)
  • max-height should be a string
  • fetch-size should be a number
  • customizedInput should extend InputComponent [For more See CORE]
  • customizedOptions should extend OptionComponent [For more See CORE]

Directive Example

  <ng-infinite-autocomplete
            data="vm.data"
            immutable
            fetch-size="vm.fetchSize"
            on-select="vm.onSelectHandler($element, $data)"
            max-height="vm.maxHeight"
            customized-input="vm.CustomInput"
            customized-options="vm.CustomOptions">
  </ng-infinite-autocomplete>

This directive will use vm.data as a static data source, and the number of fetched data is vm.fetchSize in every scroll and/or search, the data will be treated as immutable and then you need to create new instance to update the options list for the autocomplete, it will run vm.onSelectHandler($element, $data) when selecting an option passing the clicked HTNLElement as the first argument and the data as the second one ({text: 'text', value: 'hi'}), and the maxmium height for the scrollable options will be vm.maxHeight (It will be overriden if not supplying enough scrollable area for options), and will use vm.CustomInput for implementing the input, and vm.CustomOptions for implementing the custom options also.

You can exclude any attribute not desired as you like following the restrictions mentioned above.

Keywords

FAQs

Package last updated on 02 Feb 2017

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc