ng2-material-select
v0.1.8
Published
Angular 2 material-like Select Component
Downloads
21
Maintainers
Readme
Angular Material Select Component
A component inspired by material design for creating visually nice select components.
Demo
Checkout a live demo at http://www.webpackbin.com/4kAEf9Sub
Install
npm install ng2-material-select --save
API
placeholder
- defines the placeholder when no items are selectedmultiple
- defines whether it's possible to select multiple items
Example
<ng2-select [placeholder]="'Choose your framework'"
[options]="options"
[(ngModel)]="framework">
</ng2-select>
// import module
import { Ng2SelectModule } from 'ng2-material-select';
@NgModule({
imports: [ Ng2SelectModule ]
// ..
})
export class MyModule {}
Advanced Usage using objects
In case you want to use objects instead of simple arrays, you might want to use 3 further options:
displayBy
- defines the key for displaying the value of the item?selectedDisplayBy
- optional, defines the key for displaying the value once an item is selected?identifyBy
- optional, it is useful in case there is the possibility to have items with duplicate values (ex. two items with the same name). In that case, you can defined another key (ex. id) to correctly identify the item. Also, this allows the component to usetrackBy
In addition to that you may listen to a change event to get notified whenever a new option has been selected:
- onChange - optional, fires whenever a new option gets selected
Example
<ng2-select [placeholder]="'Choose your framework'"
[displayBy]="'name'"
[selectedDisplayBy]="'label'"
[identifyBy]="'name'"
[options]="options"
[(ngModel)]="framework">
</ng2-select>
import { Component } from '@angular/core';
@Component({
selector: 'app',
template: require('./home.html')
})
export class App {
framework = 'Angular 2';
options = [
{
name: 'Angular2',
label: 'ng2',
id: 0
},
{
name: 'React',
label: 'rx',
id: 1
}
];
}
TODO
- Autocomplete dropdown