更新时间 - 2017-03-22
Input 是属性装饰器，用来定义组件内的输入属性。在实际应用场合，我们主要用来实现父组件向子组件传递数据。Angular 应用是由各式各样的组件组成，当应用启动时，Angular 会从根组件开始启动，并解析整棵组件树，数据由上而下流下下一级子组件。
@Input()
counter.component.ts
import { Component,Input } from '@angular/core';
@Component({
selector: 'exe-counter',template: `
<p>当前值: {{ count }}</p>
<button (click)="increment()"> + </button>
<button (click)="decrement()"> - </button>
`
})
export class CounterComponent {
@Input() count: number = 0;
increment() {
this.count++;
}
decrement() {
this.count--;
}
}
app.component.ts
import { Component } from '@angular/core';
@Component({
selector: 'exe-app',template: `
<exe-counter [count]="initialCount"></exe-counter>
`
})
export class AppComponent {
initialCount: number = 5;
}
@Input('bindingPropertyName')
Input 装饰器支持一个可选的参数，用来指定组件绑定属性的名称。如果没有指定，则默认使用 @Input 装饰器，装饰的属性名。具体示例如下：
counter.component.ts
import { Component,template: `
<p>当前值: {{ count }}</p>
<button (click)="increment()"> + </button>
<button (click)="decrement()"> - </button>
`
})
export class CounterComponent {
@Input('value') count: number = 0;
... // 其余代码未改变
}
app.component.ts
import { Component } from '@angular/core';
@Component({
selector: 'exe-app',template: `
<exe-counter [value]="initialCount"></exe-counter>
`
})
export class AppComponent {
initialCount: number = 5;
}
@Component() - inputs
import { Component,template: `
<p>当前值: {{ count }}</p>
<button (click)="increment()"> + </button>
<button (click)="decrement()"> - </button>
`,inputs:['count:value'] // 类成员属性名称:绑定的输入属性名称
})
export class CounterComponent {
count: number = 0;
increment() {
this.count++;
}
decrement() {
this.count--;
}
}
setter & getter
setter 和 getter 是用来约束属性的设置和获取，它们提供了一些属性读写的封装，可以让代码更便捷，更具可扩展性。通过 setter 和 getter 方式，我们对类中的私有属性进行了封装，能避免外界操作影响到该私有属性。此外通过 setter 我们还可以封装一些业务逻辑，具体示例如下：
counter.component.ts
import { Component,template: `
<p>当前值: {{ count }} </p>
<button (click)="increment()"> + </button>
<button (click)="decrement()"> - </button>
`
})
export class CounterComponent {
_count: number = 0; // 默认私有属性以下划线开头，不是必须也可以使用$count
biggerThanTen: boolean = false;
@Input()
set count (num: number) {
this.biggerThanTen = num > 10;
this._count = num;
}
get count(): number {
return this._count;
}
increment() {
this.count++;
}
decrement() {
this.count--;
}
}
ngOnChanges
当数据绑定输入属性的值发生变化的时候，Angular 将会主动调用 ngOnChanges 方法。它会获得一个 SimpleChanges 对象，包含绑定属性的新值和旧值，它主要用于监测组件输入属性的变化。具体示例如下：
import { Component,Input,SimpleChanges,OnChanges } from '@angular/core';
@Component({
selector: 'exe-counter',template: `
<p>当前值: {{ count }}</p>
<button (click)="increment()"> + </button>
<button (click)="decrement()"> - </button>
`
})
export class CounterComponent implements OnChanges{
@Input() count: number = 0;
ngOnChanges(changes: SimpleChanges) {
console.dir(changes['count']);
}
increment() {
this.count++;
}
decrement() {
this.count--;
}
}
上面例子中需要注意的是，当手动改变输入属性的值，是不会触发 ngOnChanges 钩子的。
我有话说
在子组件的构造函数中，是无法获取输入属性的值，只能在 ngOnChanges 或 ngOnInit 钩子中获取到。因为子组件的构造函数会优先执行，当子组件输入属性变化时会自动调用 ngOnChanges 钩子，然后在调用 ngOnInit 钩子，所以在 ngOnInit 钩子内能获取到输入的属性。
具体详情可参考 - Angular 2 constructor & ngOnInit
2.不能同时使用 @Input 装饰器 或在 @Directive、@Component inputs 字段中定义同一个输入属性，具体示例如下：
@Component({
selector: 'exe-counter',inputs:['count:value']
})
export class CounterComponent {
@Input('value') count: number = 0;
}
3.@Input vs inputs
相同点：
它们都是用来定义输入属性
异同点：
inputs 定义在指令的 Metadata 信息中，开发者对指令的输入属性一目了然。此外对于未选用 TypeScript 作为开发语言的开发者，也只能在 Metadata 中定义指令的输入属性。
@Input 属于属性装饰器，通过它我们可以一起定义属性的访问描述符 (public、private、protected)：
@Input() public attr: string;
4.1 坚持使用 @Input 和 @Output ，而非 @Directive 和 @Component 装饰器的 inputs 和 outputs 属性：
4.2 坚持把 @Input 或者 @Output 放到所装饰的属性的同一行：
同一个属性有两个名字（一个对内一个对外）很容易导致混淆。
详细信息请参考 - Angular 2 风格指南 - STYLE 05-12
5.项目开发中尽量通过 @Input 装饰器定义无状态的组件，即组件仅依赖于输入属性，这样会大大提高组件可复用性
