dominguesgm-autocomplete
v0.13.10
Published
Angular2 Input Autocomplete adaptation from ngui-auto-complete
Downloads
6
Maintainers
Readme
auto-complete
IMPORTANT NOTICE
After 0.13.0 or higher, ng2-auto-complete has been changed to @ngui/auto-complete. Here are the changes;
- Module
ng2-auto-complete
is moved to@ngui/auto-complete
. - Direvtive
ng2-auto-complete
is moved tongui-auto-complete
. - Class name
Ng2AutoComplete
is moved toNguiAutoComplete
.
Below are plunks for different scenarios:
Template Driven Forms
ngModel http://plnkr.co/edit/3pB1Gx?p=preview
Reactive Forms
FormGroup http://plnkr.co/edit/2osUq6?p=preview issue #49
FormControl http://plnkr.co/edit/A5CW2e?p=preview issue #100
Material Design
http://plnkr.co/edit/2YLDjX?p=preview&open=app/app.component.ts
Obervable Source
http://plnkr.co/edit/ExzNSh?p=preview
List Formatter Example
http://plnkr.co/edit/F9nrWp?p=preview
http://plnkr.co/edit/0QFYFHMmCAFmhbYAGQl7?p=preview (With custom css)
Install
install @ngui/auto-complete
$ npm install @ngui/auto-complete --save
add
map
andpackages
to yoursystemjs.config.js
unless you are usingwebpack
map['@ngui/auto-complete'] = 'node_modules/@ngui/auto-complete/dist/auto-complete.umd.js';
import NguiAutoCompleteModule to your AppModule
import { NguiAutoCompleteModule } from '@ngui/auto-complete'; @NgModule({ imports: [BrowserModule, FormsModule, NguiAutoCompleteModule], declarations: [AppComponent], providers: [HTTP_PROVIDERS], bootstrap: [ AppComponent ] }) export class AppModule { }
Usage it in your code
<input auto-complete [(ngModel)]="myData" [source]="mySource" />
For full example, please check test
directory to see the example of;
systemjs.config.js
app.module.ts
- and
app.component.ts
.
Contributors are welcomed
This module is only improved and maintained by contributors like you;
As a contributor, it's NOT required to be skilled in Javascript nor Angular2. You can contribute to the following;
- Updating README.md
- Making more and clearer comments
- Answering issues and building FAQ
- Documentation
- Translation
In result of your active contribution, you will be listed as a core contributor on https://ng2-ui.github.io, and a member of ng2-ui too.
If you are interested in becoming a contributor and/or a member of ng-ui,
please send me email to allenhwkim AT gmail.com
with your github id.
attributes
All options are optional except ngModel and source
ngModel
, any, variable that autocomplete result is assigned tosource
, array or string, required. data source for dropdown listauto-complete-placeholder
, string, autocomplete input guide textvalue-formatter
, string or function variable name, custom value formatting function. e.g. '(id) value', 'myValueFormatter'.myValueFormatter(data: any): string { return `(${data[id]}) ${data[value]`; }
list-formatter
, string or function variable name, custom list formatting function. e.g. '(key) name', 'myListFormatter'.myListFormatter(data: any): string { return `(${data[key]}) ${data[name]`; }
path-to-data
, string, e.g.,data.myList
, path to array data in http responsemin-chars, number
, when source is remote data, the number of character to see dropdown listdisplay-property-name
, string, key name of text to show. default isvalue
select-value-of
, string, when selected, return the value of this key as a selected itemblank-option-text
, string, guide text to allow empty value to be selected as in empty value ofoption
tag.no-match-found-text
, string, guide text to show no result found.valueChanged
/ngModelChange
, callback function that is executed when a new dropdown is selected. e.g.(valueChanged)="myCallback($event)"
loading-text
, text to be displayed when loading. Default, "Loading"accept-user-input
boolean, iffalse
and does not match to source given, it goes back to the original value selected., If you don't event want user to type any, please usereadonly="readonly"
to force user to select only from list.max-num-list
number, maximun number of drop down list items. Default, unlimitedtab-to-select
boolean, iftrue
, pressing Tab will set the value from the selected item before focus leaves the control. Default istrue
match-formatted
boolean, iftrue
, keyword will be matched against list values formatted withlist-formatter
, instead of raw objects. Default isfalse
For Developers
To start
$ git clone https://github.com/ng2-ui/auto-complete.git
$ cd auto-complete
$ npm install
$ npm start
List of available npm tasks
npm run
: List all available tasksnpm start
: Runapp
directory for development usingwebpack-dev-server
with port 9001npm run clean
: Remove dist foldernpm run lint
: Lint TypeScript codenpm run build:ngc
: build ES modulenpm run build:umd
: Build UMD moduleng2-map.umd.js
npm run build:app
: Buildapp/build/app.js
for runnable examplesnpm run build
: Build all(clean, build:ngc, build:umc, and build:app)