ng5-auto-complete
TypeScript icon, indicating that this package has built-in type declarations

0.0.8 • Public • Published

ng5-auto-complete

This Module can be use when you want Auto-Complete Functionality on your INPUT Tag in the Angular5 Enviroment.

You can use with Reactive Angular Forms or with simple forms with ngModel directive.

1

2

3

Installation -

 
        npm install --save ng5-auto-complete
 

What it provides is -

  • WORKS with REACTIVE-ANGULAR FORMS,NORMAL-FORMS,[(ngModel)]
  • RUN on Array of Strings Array<String> or an Objects Array<Object>.
  • Open the Auto-List on Number of Word-Length you have Typed. Default 0
  • How many List-Members to be shown from Matches. Default 15
  • What Should be the TEXT on NO RECORD FOUND. Default ''

Works On -

  • TAP or CLICK
  • TAB KEY
  • ENTER KEY
  • ON BLUR

How to Start with it -

Please include these scripts in your main index.html.

 
    <link rel="stylesheet" href="//code.jquery.com/ui/1.12.1/themes/base/jquery-ui.css">
    <script src="https://code.jquery.com/jquery-1.12.4.js"></script>
    <script src="https://code.jquery.com/ui/1.12.1/jquery-ui.js"></script>
 

Now Import the AutoCompleteModule in your main NgModule of your application

and insert this module in your imports array of NgModule.

 
  //main module
  
  import { AutoCompleteModule } from 'ng5-auto-complete';
  @NgModule({
      imports :[
          AutoCompleteModule
      ]
  })
 

Its time to Integrate this module in your HTML INPUT Tag

 
    <input id="list" [ng5-auto-complete]="list">
 

This will provide the list of 15 best match from provided list.

Here are the Extented features -

  • [word-trigger] -

This is use when you want to open list on perticular word count. It Accepts Number. Default value = 0;

Example- [word-trigger]="2"

  • [list-length] -

This is use when you want to set the length of list which will open. It Accepts Number. Default value = 15;

Example- [list-length]="10"

  • filterName -

Only use when you are providing object List as Array<Object>. which thing to filter from object and show that. [{ name:"hardy", hobby:"coding"},.....] , here if filterName is name then name is filtered and shown on input tag.

Example- filterName="name"

NOTE -

If you not provide the filtername on providing the array list of objects it will throw ERROR.

  • no-record-text -

This is use when you want to show when no record found.

Example - no-record-text="No Records Found!"

USED AS -

 
<input style="margin: 40px;" id="list"
[ng5-auto-complete]="countryList" 
[word-trigger]="2" [list-length]="10"
filterName="name" no-record-text="No Records Found!" >
 

NOTE -

  • It always sets String in the input ( on any list( String or Object ) )
  • The List Above Should be of Array of Strings or Objects.
  • The Input Id should be Unique in your HTML page.

Contributions are most Wellcome.

Package Sidebar

Install

npm i ng5-auto-complete

Weekly Downloads

116

Version

0.0.8

License

ISC

Unpacked Size

55.6 kB

Total Files

23

Last publish

Collaborators

  • hardeep.singh