怎麼樣快速了解 AngularJS?
這個問題沒有標準答案,每個人的技術背景不同,切入點自然也不同。我自己先前用過 knockoutjs,第一次看到 AngularJS 的 Hello World 範例時,立刻被那種「宣告式」的語法和強大的雙向綁定給吸住了——原來不用寫一行 JS,畫面就能動起來。
AngularJS 官網首頁那幾個範例其實已經把核心特色展示得很清楚。下面我把它拆成幾個步驟,從最簡單的綁定一路做到模組化,順便把實際專案裡會用到的寫法一起帶過。
<!doctype html>
<html ng-app>
<head>
<script src="https://ngnice.com/lib/angular/1.2.16/angular.js"></script>
</head>
<body>
<div>
<label>Name:</label>
<input type="text" ng-model="yourName" placeholder="Enter a name here">
<hr>
<h1>Hello {{yourName}}!</h1>
</div>
</body>
</html>
在輸入框打字,下面的標題會即時變成「Hello 你輸入的內容!」。跟傳統寫法相比,這裡有三個關鍵:
一是 html 標籤上的 ng-app,宣告整個頁面都在 AngularJS 的管轄範圍內。二是 input 上的 ng-model="yourName",它讓輸入框的值與記憶體中的 yourName 綁在一起,雙向同步。三是 {{yourName}},這是 Angular 的表達式語法,把 yourName 的內容渲染進 h1。
如果用傳統做法,你得在 input 上掛 change 事件、拿到值、組字串、再操作 DOM 改 h1 的 innerHTML,中間還要給兩個元素加上 id 以便選取。對比之下,宣告式寫法的優勢非常明顯。
AngularJS 是個 MV* 框架。yourName 是 Model,HTML 是 View,那 Controller 在哪?改一下上面的例子:
<!doctype html>
<html ng-app>
<head>
<script src="https://ngnice.com/lib/angular/1.2.16/angular.js"></script>
</head>
<body>
<div ng-controller="testCtrl">
<label>Name:</label>
<input type="text" ng-model="yourName" placeholder="Enter a name here">
<button ng-click="clearInputValue()">Clear Input Value</button>
<hr>
<h1>Hello {{yourName}}!</h1>
</div>
<script>
function testCtrl($scope) {
$scope.yourName = "world";
$scope.clearInputValue = function () {
$scope.yourName = "";
}
}
</script>
</body>
</html>
三處改動:ng-controller="testCtrl" 宣告這個 div 內的所有元素都歸 testCtrl 管理;script 裡的 testCtrl 函數帶一個 $scope 參數,它就是 ViewModel 的載體,所有模板要用的變數與方法都掛在它身上——因為初始化時把 yourName 設成 "world",所以輸入框預設就有值;ng-click 則是綁定 click 事件,按下按鈕執行 clearInputValue,把 yourName 清空,輸入框跟著被清空。
這就是 MV* 的落地方式。有沒有覺得比手刻 DOM 事件輕鬆太多?
聰明的讀者馬上會發現問題:如果頁面上有十個 controller,難不成要宣告十個全域函數?(順帶一提,這種全域函數的寫法在 1.3.x 之後已經被移除了。)AngularJS 早就想過這件事,它有自己的模組載入機制,還引入了依賴注入。
<!doctype html>
<html ng-app="app">
<head>
<meta charset="utf-8"/>
<style>
ul { list-style: none; clear: both; }
ul > li { float: left; margin-left: 15px; display: block; }
.active { background: #1f292e; color: #FFFFFF; }
[ng\:cloak],[ng-cloak],.ng-cloak{display:none !important;}
</style>
</head>
<body ng-cloak>
<div ng-controller="testCtrl">
<ul>
<li ng-class="{'active':currentMenu == 'menu1'}"><a href="javascript:;" ng-click="selectMenu('menu1')">菜單1</a></li>
<li ng-class="{'active':currentMenu == 'menu2'}"><a href="javascript:;" ng-click="selectMenu('menu2')">菜單2</a></li>
</ul>
<br><br>
<div ng-if="currentMenu == 'menu1'">我是菜單1裡面的內容</div>
<div ng-if="currentMenu == 'menu2'">我是菜單2裡面的內容</div>
</div>
<script src="https://ngnice.com/lib/angular/1.2.16/angular.js"></script>
<script>
angular.module("app", []);
angular.module("app").controller("testCtrl", ["$scope", function ($scope) {
$scope.currentMenu = "menu1";
$scope.selectMenu = function (menu) {
$scope.currentMenu = menu;
}
}]);
</script>
</body>
</html>
這裡的關鍵是 angular.module("app", []):第一個參數是模組名稱,第二個參數是這個模組所依賴的其他模組清單(沒有依賴就給空陣列)。如果第二個參數省略,那就不是「建立」而是「取得」既有模組——這個差異是新手最常踩的坑之一。
畫面上是兩個頁籤,預設選中第一個,點哪個就顯示對應內容並套用選中樣式。ng-if 表示表達式為真才編譯並渲染裡面的元素,為假就完全不產生 DOM;ng-class="{'active': currentMenu == 'menu1'}" 則是條件成立時加上 active 這個 class。
另外 ng-cloak 搭配那段 CSS 很重要:Angular 在啟動完成前,{{ }} 會原封不動地閃在畫面上,ng-cloak 就是拿來把這個「閃一下」藏起來的。
學到這裡,試著自己做一個待辦清單:預設兩筆(一筆完成、一筆未完成),每筆前面有核取方塊切換完成狀態,下面有輸入框和新增按鈕。先別往下看,自己寫寫看。會用到的新指令是 ng-repeat:
<!DOCTYPE html>
<html ng-app="todoApp">
<head lang="en">
<meta charset="UTF-8">
<style>
.done-true { text-decoration: line-through; color: grey; }
</style>
</head>
<body>
<h2>Todo</h2>
<div ng-controller="TodoController">
<span>{{remaining()}} of {{todos.length}} remaining</span>
[ <a href="" ng-click="archive()">archive</a> ]
<ul class="unstyled">
<li ng-repeat="todo in todos">
<input type="checkbox" ng-model="todo.done">
<span class="done-{{todo.done}}">{{todo.text}}</span>
</li>
</ul>
<form ng-submit="addTodo()">
<input type="text" ng-model="todoText" size="30" placeholder="add new todo here">
<input class="btn-primary" type="submit" value="add">
</form>
</div>
<script src="https://ngnice.com/lib/angular/1.2.16/angular.js"></script>
<script>
angular.module('todoApp', [])
.controller('TodoController', ['$scope', function($scope) {
$scope.todos = [
{text:'learn angular', done:true},
{text:'build an angular app', done:false}
];
$scope.addTodo = function() {
$scope.todos.push({text:$scope.todoText, done:false});
$scope.todoText = '';
};
$scope.remaining = function() {
var count = 0;
angular.forEach($scope.todos, function(todo) {
count += todo.done ? 0 : 1;
});
return count;
};
$scope.archive = function() {
var oldTodos = $scope.todos;
$scope.todos = [];
angular.forEach(oldTodos, function(todo) {
if (!todo.done) $scope.todos.push(todo);
});
};
}]);
</script>
</body>
</html>
新增那部分的輸入框和按鈕,寫成下面這樣效果一樣:
<input type="text" ng-model="todoText" size="30" placeholder="add new todo here"> <input class="btn-primary" type="button" value="add" ng-click="addTodo()">
官方範例之所以用 <form ng-submit="addTodo()">,是為了讓使用者輸入完直接按 Enter 也能送出。這個細節在真實專案裡很重要,別偷懶。
順帶留意 class="done-{{todo.done}}" 這種寫法:class 名稱由運算式即時組出來,完成的項目會得到 done-true,未完成則是 done-false,樣式表只要針對 .done-true 加刪除線即可,完全不用碰 JS。
把上面三個例子都看懂,你已經掌握了 ng-controller、雙向綁定、寫模板,也初步用過 ng-app、ng-controller、ng-model、ng-if、ng-class、ng-click、ng-repeat 這些內建指令。老實說,已經不少了。剩下的可以慢慢探索:
用 ngRoute 寫 SPA(單頁應用程式)、自己封裝自訂 directive、Filter 過濾器、表單驗證、service / provider / factory 三種服務形式、scope 的父子樹狀結構與跨 controller 的事件廣播、$http 與 $resource 跟後端 API 互動、ngAnimate 做動畫,以及單元測試。
最後提醒一件小事:上面的範例為了方便展示,把 JS 和 CSS 全塞在同一個 HTML 裡。真實專案請務必拆成獨立檔案,這不只是整齊的問題,也直接影響快取與可維護性。
我們團隊當初也是在做 Worktile 的過程中一步步摸熟 Angular.js 的,那些必踩的坑幾乎都踩過一遍。不可否認,它是一個非常優秀的前端 MV* 框架——但也要注意它已經進入了維護狀態,新專案可以評估 Angular(2 以後的版本)、Vue 或 React。理解本文這些綁定與 directive 的觀念,換到任何一個現代框架都通用。