DIV CSS 佈局教程網

Angular2 內建指令 NgFor 與 NgIf 完全解析
編輯:關於JavaScript     

這一節要學的是如何在 Angular2 中呈現資料,並熟練使用兩個內建指令:NgFor 與 NgIf。

開始之前,請先確認你有一個能跑起來的 Angular2 範例專案——最合適的莫過於 QuickStart。本系列文章使用 TypeScript,建議先對 TypeScript 或 ES6 的類有基本認識;若你寫過 Java、C++ 這類物件導向語言,理解起來會很輕鬆。

一、在元件類別中宣告屬性

上一節我們在 app.component.ts 中導出了一個空類別,現在來填內容。先加上三個屬性:

export class AppComponent {
  username = 'dreamapple';
  age = 22;
  fruit = 'apple';
}

這其實是簡寫。完整的 TypeScript 寫法應該明確標註型別,並在建構子中初始化:

export class AppComponent {
  username: string;
  age: number;
  fruit: string;

  constructor() {
    this.username = 'dreamapple';
    this.age = 22;
    this.fruit = 'apple';
  }
}

二、撰寫樣板

樣板 HTML 較多時,用反引號包住會比單行字串清楚得多:

@Component({
  selector: 'my-app',
  template: `
    <p>My name is: {{username}}</p>
    <p>My age is: {{age}}</p>
    <p>My favorite fruit is: {{fruit}}</p>
  `
})

也可以改用 templateUrl 把樣板抽到外部檔案:

@Component({
  selector: 'my-app',
  templateUrl: 'app/templates/app-template.html'
})

這裡的路徑 app/templates/app-template.html 是相對於程式根目錄 app(而非 angular2-travel),把先前寫的 HTML 片段複製過去即可。

資料呈現仍沿用 Angular1 的雙大括號插值語法,插值符號出現的位置就是要顯示資料的地方。

三、NgFor:迴圈渲染列表

NgFor 和 Angular1 的 ng-repeat 幾乎一樣,用來遍歷可迭代物件,通常是陣列。先加上一個陣列屬性:

export class AppComponent {
  username = 'dreamapple';
  age = 22;
  fruitsList = ['apple', 'orange', 'pear', 'banana'];
  fruit = this.fruitsList[0];   // 必須用 this 指向已定義的屬性
}

最後那行的註解是重點:一定要寫 this.fruitsList,直接寫 fruitsList 的話 Angular 無法解析它指的是什麼。

接著在樣板中遍歷:

@Component({
  selector: 'my-app',
  template: `
    <p>My name is: {{username}}</p>
    <p>My age is: {{age}}</p>
    <ul>
      <li *ngFor="let fruit of fruitsList">{{fruit}}</li>
    </ul>
    <p>My favorite fruit is: {{fruit}}</p>
  `
})

開頭的星號不能省。若把 *ngFor 寫成 ngFor,程式不會報錯,但只會渲染出陣列的第一項——這是新手最常踩的坑。星號代表 Angular 會把這個元素包進一個 template 中,並對每一項各建立一份實例。

我們也可以在表達式中取得索引:

<li *ngFor="let fruit of fruitsList; let i = index;">{{i}}-{{fruit}}</li>

這裡有兩個細節:*ngFor 後面接的是表達式,所以可以寫簡單運算;而 let 關鍵字建立了區塊級作用域,讓這些變數只在這個迴圈區塊內有效,不會污染外部。

四、NgIf:條件渲染

NgIf 與 Angular1 的 ng-if 概念相同:依表達式的值決定要在 DOM 上加入或移除整個元素。

<p *ngIf="fruitsList.length > 3">fruitsList 的長度大於 3</p>
<p *ngIf="fruitsList.length <= 3">fruitsList 的長度不大於 3</p>

同樣要帶星號,表達式預期回傳 Boolean 值。注意 NgIf 與 ng-show 的本質差異:NgIf 是真的把元素從 DOM 中移除與重建,而 ng-show 只是切換 CSS display。因此 NgIf 更省資源,但也代表元素內部的狀態會在移除後丟失。

五、用 TypeScript 類別建立模型

既然用了 TypeScript,就可以定義類別來建構物件。先在 app 資料夾下建立 classes 資料夾,新增 Fruit.ts:

export class Fruit {
  constructor(public name: string, public price: number) {}
}

這裡用了 TypeScript 的參數屬性語法:在建構子的參數前加上 public,就同時完成了屬性宣告與初始化,省去另外寫 this.name = name 的功夫。

在元件中引入並使用:

import { Fruit } from './classes/Fruits';

export class AppComponent {
  username = 'dreamapple';
  age = 22;

  fruitsList = [
    new Fruit('apple', 20),
    new Fruit('orange', 30),
    new Fruit('pear', 40),
    new Fruit('banana', 50)
  ];

  fruit = this.fruitsList[0].name;
}

樣板也隨之調整為取用物件屬性:

<li *ngFor="let fruit of fruitsList; let i = index;">
  {{i}}-{{fruit.name}}-{{fruit.price}}
</li>

最終呈現如下:

小結

ES6 與 TypeScript 讓 Angular 開發有了近似 Java 的感覺,這算是有利有弊:好處是程式碼可讀性高、易維護、適合大型專案與團隊協作;代價則是學習成本提高。但整體而言,型別系統帶來的保障在專案規模變大後會越來越明顯。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved