Angular 2 屬性指令 vs 結構指令

Angular 2 的指令有以下三種：

• 組件(Component directive)：用于構建UI組件，繼承于 Directive 類

• 屬性指令(Attribute directive):  用于改變組件的外觀或行為

• 結構指令(Structural directive):  用于動態添加或刪除DOM元素來改變DOM布局

組件

import { Component } from '@angular/core';

@Component({  
    selector: 'my-app', // 定義組件在HTML代碼中匹配的標簽  
    template: `<h2>Hello `name`</h2>`,  // 指定組件關聯的內聯模板
})
export class AppComponent  {  name = 'Angular'; }

Angular 2 內置屬性指令

1.ngStyle指令： 用于設定給定 DOM 元素的 style 屬性

使用常量

<div [ngStyle]="{'background-color': 'green'}"></div>

使用變量

<div [ngStyle]="{'background-color': person.country === 'UK' ? 'green' : 'red'}">

具體示例：

import { Component } from '@angular/core';

@Component({
    selector: 'ngstyle-example',
    template: `
        <h5>NgStyle</h5>
        <ul *ngFor="let person of people">
            <li [ngStyle]="{'color': getColor(person.country)}"> 
                {{ person.name }} (`person`.`country`)
            </li>
        </ul>
`})
export class NgStyleExampleComponent {    
    getColor(country: string) { 
        switch (country) { 
        case 'CN': 
            return 'red';
        case 'USA': 
            return 'blue';
        case 'UK': 
            return 'green';
       }    
    }    
    
    people: any[] = [
        { name: "Semlinker", country: 'CN' },
        { name: "Donald John Trump", country: 'USA' },
        { name: "Daniel Manson", country: 'UK' }    
     ];
}

上面的例子，除了使用 ngStyle 指令，我們還可以使用 [style.<property>] 的語法：

 <ul *ngFor="let person of people">     
     <li [style.color]="getColor(person.country)">
         {{ person.name }} (`person`.`country`)
     </li>
</ul>

2.ngClass指令：用于動態的設定 DOM 元素的 CSS class

使用常量

<div [ngClass]="{'text-success': true }"></div>

使用變量

<div [ngClass]="{'text-success': person.country === 'CN'}"></div>

具體示例：

import { Component } from '@angular/core';

@Component({
    selector: 'ngclass-example',
    template: `
        <style>
            .text-success { color: green } 
            .text-primary { color: red }      
            .text-secondary { color: blue }
        </style>
        <h5>NgClass</h5>
        <ul *ngFor="let person of people">
            <li [ngClass]="{ 'text-success': person.country === 'UK', 
                'text-primary': person.country === 'CN',
                'text-secondary': person.country === 'USA'}">
                {{ person.name }} (`person`.`country`)
            </li>
        </ul>`,
})
export class NgClassExampleComponent {    

    people: any[] = [
        { name: "Semlinker", country: 'CN' },
        { name: "Donald John Trump", country: 'USA' },
        { name: "Daniel Manson", country: 'UK' }    
    ];
}

Angular 2 內置結構指令

1.ngIf指令：根據表達式的值，顯示或移除元素

<div *ngIf="person.country === 'CN'">
    {{ person.name }} (`person`.`country`)
</div>

2.ngFor指令：使用可迭代的每個項作為模板的上下文來重復模板，類似于 Ng 1.x 中的 ng-repeat 指令

<div *ngFor="let person of people">`person`.`name`</div>

3.ngSwitch指令：它包括兩個指令，一個屬性指令和一個結構指令。它類似于 JavaScript 中的 switch 語句

<ul [ngSwitch]='person.country'>  
    <li *ngSwitchCase="'UK'" class='text-success'>
        {{ person.name }} (`person`.`country`)  
    </li>  
    <li *ngSwitchCase="'USA'" class='text-secondary'>
        {{ person.name }} (`person`.`country`)
    </li> 
    <li *ngSwitchDefault class='text-primary'>
        {{ person.name }} (`person`.`country`)
    </li>
</ul>

通過上面的例子，可以看出結構指令和屬性指令的區別。結構指令是以 * 作為前綴，這個星號其實是一個語法糖。它是 ngIf 和 ngFor 語法的一種簡寫形式。Angular 引擎在解析時會自動轉換成 <template> 標準語法。

Angular 2 內置結構指令標準形式

1.ngIf指令：

<template [ngIf]='condition'>  
 <p>I am the content to show</p>
</template>

2.ngFor指令：

<template ngFor [ngForOf]="people" let-person>   
    <div> {{ person.name }} (`person`.`country`) </div>
</template>

3.ngSwitch指令：

<ul [ngSwitch]='person.country'>  
    <template [ngSwitchCase]="'UK'">
      <li class='text-success'> 
         {{ person.name }} (`person`.`country`)
      </li>
    </template>
    <template [ngSwitchCase]="'USA'">
       <li class='text-secondary'> 
         {{ person.name }} (`person`.`country`)
       </li>  
    </template>  
    <template [ngSwitchDefault]> 
        <li class='text-primary'>
         {{ person.name }} (`person`.`country`)
        </li>
    </template>
</ul>

Angular 2 內置結構指令定義

1.ngIf指令定義：

@Directive({selector: '[ngIf]'})
export class NgIf {}

2.ngFor指令定義：

@Directive({selector: '[ngFor][ngForOf]'})
export class NgForOf<T> implements DoCheck, OnChanges {}

3.ngSwitch指令定義：

@Directive({selector: '[ngSwitch]'})
export class NgSwitch {}

@Directive({selector: '[ngSwitchCase]'})
export class NgSwitchCase implements DoCheck {}

@Directive({selector: '[ngSwitchDefault]'})
export class NgSwitchDefault {}

自定義屬性指令

指令功能描述：該指令用于在用戶點擊宿主元素時，根據輸入的背景顏色，更新宿主元素的背景顏色。宿主元素的默認顏色是×××。

1. 指令實現

import {Directive, Input, ElementRef, HostListener} from "@angular/core";

@Directive({  selector: '[exeBackground]'})
export class BeautifulBackgroundDirective {  

    private _defaultColor = 'yellow';  
    private el: HTMLElement;  
    
    @Input('exeBackground')  backgroundColor: string;  
    constructor(el: ElementRef) {    
        this.el = el.nativeElement;    
        this.setStyle(this._defaultColor);  
    }  @HostListener('click')  
    
    onClick() { 
        this.setStyle(this.backgroundColor || this._defaultColor);  
    }  
    
    private setStyle(color: string) { 
        this.el.style.backgroundColor = color;  
    }
}

2.指令應用：

import { Component } from '@angular/core';

@Component({  
    selector: 'my-app',
    template: `<h2 [exeBackground]="'red'">Hello `name`</h2>`,
})
export class AppComponent  {  
    name = 'Angular'; 
}

自定義結構指令

指令功能描述：該指令實現 ngIf 指令相反的效果，當指令的輸入條件為 Falsy 值時，顯示DOM元素。

1.指令實現

@Directive({  selector: '[exeUnless]'})
export class UnlessDirective {  
    @Input('exeUnless')  
    set condition(newCondition: boolean) {    
        if (!newCondition) { 
            this.viewContainer.createEmbeddedView(this.templateRef);
        } else {     
            this.viewContainer.clear();    
        }  
    }  
    
    constructor(private templateRef: TemplateRef<any>,     
        private viewContainer: ViewContainerRef) {  }
}

2.指令應用

import { Component } from '@angular/core';

@Component({ 
    selector: 'my-app',  
    template: `<h2 [exeBackground]="'red'" 
        *exeUnless="condition">Hello `name`</h2>`, 
})
export class AppComponent  {  
    name = 'Angular';   
    condition: boolean = false;
}

總結

本文主要介紹了 Angular 2 中的屬性指令和結構指令，通過具體示例介紹了 Angular 2 常見內建指令的使用方式和區別。最終，我們通過自定義屬性指令和自定義結構指令兩個示例，展示了如何開發自定義指令。