Angular 2 模板语法与常用指令简介

一、模板语法简介

插值表达式

<div>Hello `name`</div>

等价于

<div [textContent]="interpolate(['Hello'], [name])"></div>

模板表达式

1.属性绑定

1.1输入属性的值为常量

<show-title title="Some Title"></show-title>

等价于

<show-title [title]="'Some Title'"></show-title>

1.2输入属性的值为实例属性

<show-title [title]="title"></show-title>

等价于

<show-title bind-title="title"></show-title>

2.事件绑定

<date-picker (dateChanged)="statement()"></date-picker>

等价于

<date-picker on-dateChanged="statement()"></date-picker>

模板引用变量

<video-player #player></video-player> 
<button (click)="player.pause()">Pause</button>

等价于

<video-player ref-player></video-player>

双向绑定

<input [ngModel]="todo.text" (ngModelChange)="todo.text=$event">

等价于

<input [(ngModel)]="todo.text">

*与<template>

1.*ngIf

<hero-detail *ngIf="currentHero" [hero]="currentHero"></hero-detail>

最终转换为

<template [ngIf]="currentHero">  
    <hero-detail [hero]="currentHero"></hero-detail>
</template>

2.*ngFor

<hero-detail *ngFor="let hero of heroes; trackBy:trackByHeroes" 
    [hero]="hero">
</hero-detail>

最终转换为

<template ngFor let-hero [ngForOf]="heroes" 
    [ngForTrackBy]="trackByHeroes">  
        <hero-detail [hero]="hero"></hero-detail>
</template>

常用指令简介

NgIf

<div *ngIf="false"></div> <!-- never displayed -->
<div *ngIf="a > b"></div> <!-- displayed if a is more than b -->
<div *ngIf="str == 'yes'"></div> <!-- displayed if str holds the string "yes" -->
<div *ngIf="myFunc()"></div> <!-- displayed if myFunc returns a true value -->

NgSwitch

有时候需要根据不同的条件，渲染不同的元素，此时我们可以使用多个 ngIf 来实现。

<div class="container">    
    <div *ngIf="myVar == 'A'">Var is A</div> 
    <div *ngIf="myVar == 'B'">Var is B</div> 
    <div *ngIf="myVar != 'A' && myVar != 'B'">Var is something else</div>
</div>

如果 myVar 的可选值多了一个 'C'，就得相应增加判断逻辑：

<div class="container"> 
    <div *ngIf="myVar == 'A'">Var is A</div>
    <div *ngIf="myVar == 'B'">Var is B</div>
    <div *ngIf="myVar == 'C'">Var is C</div>
    <div *ngIf="myVar != 'A' && myVar != 'B' && myVar != 'C'">
        Var is something else    
    </div>
</div>

可以发现 Var is something else 的判断逻辑，会随着 myVar  可选值的新增，变得越来越复杂。遇到这种情景，我们可以使用 ngSwitch 指令。

<div class="container" [ngSwitch]="myVar">    
    <div *ngSwitchCase="'A'">Var is A</div>
    <div *ngSwitchCase="'B'">Var is B</div
    <div *ngSwitchCase="'C'">Var is C</div>
    <div *ngSwitchDefault>Var is something else</div>
</div>

NgStyle

NgStyle 让我们可以方便得通过 Angular 表达式，设置 DOM 元素的 CSS 属性。

• 设置元素的背景颜色

<div [style.background-color="'yellow'"]>  Use fixed yellow background</div>

• 设置元素的字体大小

<!-- 支持单位: px | em | %-->
<div>   
    <span [ngStyle]="{color: 'red'}" [style.font-size.px]="fontSize">
        red text
    </span>
</div>

NgStyle 支持通过键值对的形式设置 DOM 元素的样式：

<div [ngStyle]="{color: 'white', 'background-color': 'blue'}">  
     Uses fixed white text on blue background
</div>

注意到 background-color 需要使用单引号，而 color 不需要。这其中的原因是，ng-style 要求的参数是一个 Javascript 对象，color 是一个有效的 key，而 background-color 不是一个有效的 key ，所以需要添加 ''。

NgStyle 源码片段

@Directive({selector: '[ngStyle]'})
export class NgStyle implements DoCheck {  
    private _ngStyle: {[key: string]: string};  
    
    private _differ: KeyValueDiffer<string, string|number>;  
    
    constructor(    private _differs: KeyValueDiffers,     
        private _ngEl: ElementRef, private _renderer: Renderer) {}  
        
    @Input()  set ngStyle(v: {[key: string]: string}) {     
        // <div [ngStyle]="{color: 'white', 'background-color': 'blue'}">    
        this._ngStyle = v;    if (!this._differ && v) {     
          this._differ = this._differs.find(v).create();   
           } 
         }   
         
         // 设置元素的样式  private _setStyle(nameAndUnit: string, 
         value: string|number): void {    
         const [name, unit] = nameAndUnit.split('.'); 
         // 截取样式名和单位    
         value = value != null && unit ? `${value}${unit}` : value;  
         this._renderer.setElementStyle(this._ngEl.nativeElement, name, 
             value as string); 
     }
}

NgClass

NgClass 接收一个对象字面量，对象的 key 是 CSS class 的名称，value 的值是 truthy/falsy 的值，表示是否应用该样式。

• CSS Class

.bordered {    border: 1px dashed black; background-color: #eee;}

• HTML

<!-- Use boolean value -->
<div [ngClass]="{bordered: false}">
    This is never bordered
</div>

<div [ngClass]="{bordered: true}">
    This is always bordered
</div>

<!-- Use component instance property -->
<div [ngClass]="{bordered: isBordered}"> 
    Using object literal. Border {{ isBordered ? "ON" : "OFF" }}
</div>

<!-- Class names contains dashes -->
<div[ngClass]="{'bordered-box': false}">
    Class names contains dashes must use single quote
</div>

<!-- Use a list of class names -->
<div class="base" [ngClass]="['blue', 'round']">
    This will always have a blue background and round corners
</div>

NgFor

NgFor 指令用来根据集合(数组) ，创建 DOM 元素，类似于 ng1 中 ng-repeat 指令

<div class="ui list" *ngFor="let c of cities; let num = index"> 
  <div class="item">{{ num+1 }} - {{ c }}</div>
</div>

使用 trackBy 提高列表的性能

@Component({  
    selector: 'my-app', 
    template: `
    <ul>
      <li *ngFor="let item of collection;trackBy: trackByFn">
       `item`.`id`
      </li>   
    </ul>    
    <button (click)="getItems()">Refresh items</button> 
`,})
export class App {  
    constructor() {    
        this.collection = [
            {id: 1}, 
            {id: 2}, 
            {id: 3}
         ];  
    } 
    
    getItems() {    
        this.collection = this.getItemsFromServer(); 
    }    
    
    getItemsFromServer() { 
        return [{id: 1}, {id: 2}, {id: 3}, {id: 4}];  
    }    
    
    trackByFn(index, item) {    
        return index; // or item.id  
    }
}

NgNonBindable

ngNonBindable 指令用于告诉 Angular 编译器，无需编译页面中某个特定的HTML代码片段。

<div class='ngNonBindableDemo'> 
    <span class="bordered">{{ content }}</span>
    <span class="pre" ngNonBindable>
        &larr; This is what {{ content }} rendered    
    </span>
</div>

注意事项

1.使用 [hidden] 属性控制元素的可见性

<div [hidden]="!showGreeting">  Hello, there!</div>

上面的代码在通常情况下，都能正常工作。但当在对应的 DOM 元素上设置 display: flex 属性时，尽管[hidden] 对应的表达式为 true，但元素却能正常显示。对于这种特殊情况，则推荐使用 *ngIf。

2.直接使用 DOM API 获取页面上的元素

@Component({  
    selector: 'my-comp',
    template: `
        <input type="text" /> 
        <div> Some other content </div> 
`})
export class MyComp {  
    constructor(el: ElementRef) {    
        el.nativeElement.querySelector('input').focus(); 
    }
}

以上的代码直接通过 querySelector() 获取页面中的元素，通常不推荐使用这种方式。更好的方案是使用 @ViewChild 和模板变量，具体示例如下：

@Component({  
    selector: 'my-comp', 
    template: `
        <input #myInput type="text" />
        <div> Some other content </div>  
`})
export class MyComp implements AfterViewInit {  
    @ViewChild('myInput') input: ElementRef; 
    
     constructor(private renderer: Renderer) {}  
     
     ngAfterViewInit() {    
         this.renderer.invokeElementMethod( 
           this.input.nativeElement, 'focus');    
     }
}

另外值得注意的是，@ViewChild() 属性装饰器，还支持设置返回对象的类型，具体使用方式如下：

@ViewChild('myInput') 
myInput1: ElementRef;

@ViewChild('myInput', {read: ViewContainerRef})
myInput2: ViewContainerRef;

若未设置 read 属性，则默认返回的是 ElementRef 对象实例。