Angular 新手入門

Angular 是一個基於TypeScript的開發平台。身為一個平台，Angular 包含：

• 一個元件化的框架，用來建構可延展的 Web 應用程式。
• 一整套經深思熟慮而整合出來的函式庫，包含各種不同的功能，包含路由機制、表單管理、Client/Server 通訊，以及更多。
• 一組完善的開發工具，幫助你開發、建置、測試、更新你的程式碼。

你能使用 Angular 去開發多種不同規模的專案，小至單人應用式專案，大至大型企業級專案。Angular 的設計宗旨是讓後續更新升級十分容易，因此你能輕鬆的使用最新版本進行開發。最棒的是，Angular 的開發生態圈龐大，有超過一百七十萬的使用者、套件開發者以及內容創作者。

在開始探索 Angular 之前，你要先瞭解 Angular CLI。Angular CLI 是一種快速、簡單、備受推崇的 Angular 程式開發方式。Angular CLI 能讓許多任務變得更容易，以下是一些範例：

在建造應用程式時，你會發現 Angular CLI 是很實用的工具。

這一系列的教學會帶領你建立一個待辦事項程式。透過這個程式，你會學到如何使用 Angular 管理、編輯、增加、刪除和篩選項目。

想在本地端安裝 Angular，你必須安裝：

• Node.js Angular 需要使用 Node.js 的當前版、活躍 LTS 版或是長期維護 LTS 版若需特定版本的資訊，可以參閱在package.json檔案之中的engines關鍵字。 若想更了解如何安裝 Node.js，可參閱nodejs.org。若你不確定你目前使用的 Node.js 版本號，請在終端機輸入node -v查閱。
• npm 套件管理器 Angular、Angular CLI 以及 Angular 應用程式都依賴 npm 套件 來實現許多特性與功能。想下載並安裝 npm 套件，你需要使用 npm 套件管理器。本教學使用npm 客戶端命令列介面，該介面預設安裝在Node.js。欲檢查你是否安裝了 npm 客戶端，請在終端視窗中執行npm -v。

你可以在終端機裡透過使用 Angular 命令列介面（CLI）來產生、建置、測試和佈署 Angular 應用程式。請在終端機裡執行以下指令來安裝 Angular 命令列介面：

npm install -g @angular/cli

Angular CLI 的指令開頭均為ng，接著是你希望 CLI 進行的事項。在桌面目錄中，使用 ng new指令創建一個名為todo的專案：

ng new todo --routing=false --style=css

使用ng new指令會在桌面創建一個小型入門 Angular 的專案。其他的標籤，--routing和--style，則是定義專案中的導航與樣式。本教學導覽會在後續篇章詳細解釋這些特性。

如果被詢問是否使用嚴格型別檢查模式，可以回覆「同意」。

輸入cd指令切換到你新開的專案：

cd todo

想執行你的todo專案，請使用ng serve：

ng serve

當 CLI 詢問是否使用情況分析，回覆no。

在瀏覽器中，導至http://localhost:4200/來查看你新建的專案。如果你更改任何原始資料夾，應用程式會自動加載更新。

當ng serve運行時，你或許會想開啟第二個終端機視窗來運行其他指令。如果你想中斷應用程式運行，請在終端機內按下Ctrl+c。

本教學導覽主要是用的程式原始檔在src/app資料夾內。由 CLI 自動產生的主要檔案如下：

1. app.module.ts：列出此專案使用的所有檔案。此檔案在專案中扮演中央樞紐的角色。
2. app.component.ts：又被稱為元件類別（Class），內含此專案主要頁面的相關邏輯
3. app.component.html：內含AppComponent所使用的網頁 html。這個檔案的內容也被視為元件模板（Template），此模板定義你在瀏覽器中看到的畫面。
4. app.component.css：內含AppComponent裡面的樣式。當你想定義某些樣式給特定模組使用，卻不希望影響到整體程式時，便可使用此檔案進行設定。

一個 Angular 的元件由三部份構成，分別是：模板、樣式、類別。舉例來說，app.component.ts、app.component.html、以及app.component.css一同構成AppComponent。此結構會將邏輯、畫面、樣式分開，如此一來便能讓程式更易於維護與擴張。

如此一來，你就能在一開始便依循最佳的實作慣例。

Angular CLI 也能產生app.component.spec.ts的元件測試檔案，但本次教學導覽不會深入探討測試的部分，所以你可以忽略這個檔案。

一旦你建立一個元件，CLI 就會按照你的命名在目錄中建立此四個檔案。

Angular 基本上是用 TypeScript 作為主要開發的語言。 簡單來說，TypeScript 是 JavaScript 的超集合，也就是說在 JavaScript 中使用的語法也同樣適用於 TypeScript。 而 TypeScript 比純 JavaScript 更加強化型別的規範、寫法也更簡潔，因此使用 TypeScript 可以寫出更好維護的程式碼，並減少報錯的機率。

在 Angular 框架裡，主要是由許多元件（Components）來組成。 一個元件包含 HTML 頁面架構、樣式以及帶有元件裝飾器@Component()的 TypeScript 類別（class）。

類別(class)裡會放這個元件的邏輯、規則， 舉例來說像是函式、事件監聽、屬性和參考等等。 類別會放在一個像是feature.component.ts的檔案裡，而feature就是你的元件名稱。 所以你可以建立一些檔案，並且命名為像是header.component.ts、signup.component.ts或是feed.component.ts。 當你建立一個元件，它會帶有@Component() 這樣的裝飾器，裡面會有檔案的路徑指向，告訴 Angular 要去哪裡找 HTML 和 CSS 檔案。 一個基本的元件寫法如下：

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

@Component({
  selector: "app-item",
  // 接下來的檔案路徑會指出其它檔案在什麼位置
  templateUrl: "./item.component.html",
  styleUrls: ["./item.component.css"],
})
export class ItemComponent {
  // 程式碼寫在這裡
}

這個元件會被稱為ItemComponent，它的選擇器是app-item。 這個選擇器就像 HTML 的標籤，你可以把它放在其它的模版裡。 當瀏覽器渲染到選擇器的時候，就會把這個元件的模版給渲染出來。 這份教學文件會指引你建立兩個元件，並把其中一個放到另一個元件裡。

Angular 的元件模組具備高度封裝性，讓專案結構看起來更直覺。 而 Angular 的元件也讓專案更易於做單元測試、讓程式碼更易於解讀。

每個元件都會有 HTML 模版去告訴瀏覽器要如何渲染頁面。HTML 可以直接內嵌寫在類別（Class）的檔案內，或是用檔案路徑去指明其位置。

而要去指明位在他處的 HTML 檔案，就要使用templateUrl這個屬性，範例如下：

@Component({
  selector: "app-root",
  templateUrl: "./app.component.html",
})
export class AppComponent {}

當你把 HTML 內嵌寫在類別（Class）的檔案內時，要使用template這個屬性，並用反引號把 HTML 包起來，範例如下：

@Component({
  selector: "app-root",
  template: `<h1>Hi!</h1>`,
})
export class AppComponent {}

Angular 還擴充了 HTML 的語法，讓你可以在元件中使用動態插值。 當你的元件狀態改變時，Angular 會自動重新渲染該節點。 下面的例子中會使用插值去插入一段文字來示範這個功能。

<h1>{{ title }}</h1>

雙花括號的地方就是告訴 Angular 插值顯示的地方。 title的值就是從元件的類別來的：

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

@Component({
  selector: "app-root",
  templateUrl: "./app.component.html",
  styleUrls: ["./app.component.css"],
})
export class AppComponent {
  title = "To do application";
}

當載入完元件和它的模版時，會在瀏覽器看到如下的呈現：

<h1>To do application</h1>

每個專案裡會有個全域性的樣式設定檔案styles.css，所有的元件都可以繼承它，並且再各自增加或覆寫它的樣式設定。 你可以直接在裝飾器@Component()裡寫出這個元件特有的樣式，或是用路徑指明它的 CSS 檔案位置。

要直接在元件裝飾器內設定樣式，就要使用styles這個屬性，範例如下：

@Component({
  selector: 'app-root',
  templateUrl: './app.component.html',
  styles: ['h1 { color: red; }']
})

但基本上，元件通常會把樣式另外寫在一個檔案，並用styleUrls去指明它的檔案路徑，如下：

@Component({
  selector: 'app-root',
  templateUrl: './app.component.html',
  styleUrls: ['./app.component.css']
})

以此去寫出這個元件特定的樣式，讓你更容易去維護你的 CSS 檔案。

以上這些就是關於 Angular 的簡介。這時候的你，應該已經對 Angular 的運作有基本的了解，並準備建立一個 Angular 的專案。在下一篇文章裡，我們會更深入的應用這些知識，並且試著用 Angular 去寫一個「待辦清單」。

• 前頁 (en-US)
• 概述：理解 JavaScript 前端框架
• 次頁