This is a fork of Orizens' ngx-typeahead, which, in their turn, is an extract of the typeahead component from the open source Echoes Player.
Its built with JSONP support by default.
Supports HTTP remote source with any http method (get, post etc..).
Supports static list (in array form).
Now, ngx-typeahead now follows Angular versions, starting with ngx-typeahead@6.0.0 for Angular 6.X.X.
For Angular 4.3/5.X (With the new HttpClient)- please use version > 0.2.1
For Angular 2, 4 (Without HttpClient)- please use version 0.0.3
AOT compatible
npm install ngx-typeahead --save-dev
Input | Type | Required | Description |
---|---|---|---|
taUrl | string | YES | the url of a remote server that supports jsonp calls. |
taParams | { key: string, value: any} | optional, default: {} | a {key,value} (json) object to include as params for the json call. Each api supports different structure. |
taQueryParam | query | optional, default: 'q' | a string member which is set with the query value for search. |
taCallbackParamValue | query | optional, NO Default | a string value for the callback query parameter. |
taItemTpl | TemplateRef | - optional | a template reference to be used for each result item. |
taApi | string | optional, default: 'jsonp' | the utility to make a request with - 'jsonp', 'http'. |
taApiMethod | string | optional, default: 'get' | the method to be used in either 'jsonp' or 'http'. |
taList | any[] | optional | provide a static list of items to display. This prevents any remote request and has first precedence. |
taListItemField | string[] | optional | if item in static list is an object, this list of keys in the object that are checked when the list is filtered with the query. if list is empty, all keys are checked |
taListItemLabel | string | optional | if static list of type object - this label is used as the key for displaying the item in the suggestions list - item[label] |
taDebounce | number | optional | set the debounce time before a request is called |
taAllowEmpty | boolean | optional, default: false | if true, it allows empty strings to pass and invoke search |
taCaseSensitive | boolean | optional, default: false | if true, comparing query is performed with case sensitive |
taDisplayOnFocus | boolean | optional, default: false | if true, will display results (if exist) when input is clicked |
taMapper | function | optional, default: (items) => items | if provided, will be used to map server response to required format |
taHeaders | Object | optional, default: {} | if provided, corresponding headers will be appended to each API request (object keys should be headers' names, and object values - well, headers' values) |
Output | Type | Required | Description |
---|---|---|---|
taSelected | string | YES | emits an event once the item is selected. |
Demo with all parameters StackBlitz
First, import the NgxTypeaheadModule to your module:
import { NgModule } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { NgxTypeaheadModule } from 'ngx-typeahead';
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
import { AppComponent } from './app';
@NgModule({
imports: [BrowserModule, NgxTypeaheadModule],
declarations: [AppComponent],
bootstrap: [AppComponent]
})
export class AppModule {}
platformBrowserDynamic().bootstrapModule(AppModule);
Then, in app component:
import { Component } from '@angular/core';
@Component({
selector: 'app',
template: `
<div class="search-results">
<input [value]="search"
ngxTypeahead
[taUrl]="url"
[taParams]="params"
(taSelected)="handleResultSelected($event)"
>
</div>
`
})
export class AppComponent {
public url = 'http://suggestqueries.google.com/complete/search';
public params = {
hl: 'en',
ds: 'yt',
xhr: 't',
client: 'youtube',
q: query
};
public search = '';
handleResultSelected(result) {
this.search = result;
}
}
import { Component } from '@angular/core';
@Component({
selector: 'app',
template: `
<div class="search-results">
<input [value]="search"
ngxTypeahead
[taUrl]="url"
[taParams]="params"
[taItemTpl]="itemTpl"
(taSelected)="handleResultSelected($event)"
>
<ng-template #itemTpl let-result>
<strong>MY {{ result.result }}</strong>
</ng-template>
</div>
`
})
export class AppComponent {
public url = 'http://suggestqueries.google.com/complete/search';
public params = {
hl: 'en',
ds: 'yt',
xhr: 't',
client: 'youtube',
q: query
};
public search = '';
handleResultSelected(result) {
this.search = result;
}
}