Skip to content

mhaider110/ng-simple-autocomplete

Repository files navigation

NgSimpleAutocomplete

This project was generated with Angular CLI version 6.1.1.

Features

ng-simple-autocomplete2 is autocomplete component for Angular2+. It uses data(json array) and item(key in josn to populate dropdown) from it's parent component and filter based on search.

  • Data filtering.
  • Custom styling.
  • Event binding.
  • Multi-select with search
  • Select using keyboard

Demo

Installation

npm install ng-simple-autocomplete2

Add it to your Angular Module.

import { NgSimpleAutocompleteModule } from 'ng-simple-autocomplete2';

@NgModule({
  imports: [
    NgSimpleAutocompleteModule
  ]
})
export class AppModule { }

Usage

Template - somecomponent.component.html
<ng-simple-autocomplete
[placeholder]="placeholder"
[sourceArray]="data"
[fieldNameFormatter]="returnFieldFromObject"
(onSelect)="selectedObject($event)"
[multiSelect]="true">
</ng-simple-autocomplete>
Dataset properties and event - somecomponent.component.ts
export class SomeComponent {
  placeholder = "Search";
  // source array
  data = [{
    'code': '01',
    'day': [{
      'lang': 'english',
      'value': 'Sunday'
    }, {
      'lang': 'french',
      'value': 'dimanche'
    }],
    'month': [{
      'lang': 'english',
      'value': 'May'
    }, {
      'lang': 'french',
      'value': 'Mai'
    }]
  }
];

  returnFieldFromObject(item) {
	// item represent one object in above data array.
	// you can return any field that will be use to populate drop-down
    return item.day[0].value;
  }
  // Selected object
  selectedObject(item) {
	// do something with selected item (object)
    console.log(item);
  }
}

Development server

Run ng serve for a dev server. Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files.

Code scaffolding

Run ng generate component component-name to generate a new component. You can also use ng generate directive|pipe|service|class|guard|interface|enum|module.

Build

Run ng build to build the project. The build artifacts will be stored in the dist/ directory. Use the -prod flag for a production build.

Running unit tests

Run ng test to execute the unit tests via Karma.

Running end-to-end tests

Run ng e2e to execute the end-to-end tests via Protractor. Before running the tests make sure you are serving the app via ng serve.

Further help

To get more help on the Angular CLI use ng help or go check out the Angular CLI README.

About

Simple auto-complete dropdown

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors