是時候為這些網頁注入動態能力了——用 AngularJS!我們先為隨後要加入的控制器寫好一個測試。
應用的程式架構有許多種做法。對 AngularJS 應用而言,我們鼓勵採用模型—視圖—控制器(MVC)模式來解耦程式碼、分離關注點。基於這個思路,我們就用 AngularJS 為應用加入一些模型、視圖與控制器。
先重置工作目錄:
git checkout -f step-2
此時應用已經擁有一份包含三支手機的清單。步驟 1 與步驟 2 之間最重要的差異如下(完整差異可到 GitHub 查看)。
在 AngularJS 中,一個視圖是模型透過 HTML 模板渲染後的映射。這代表只要模型一有變化,AngularJS 就會即時更新結合點,進而更新視圖。例如,視圖組件由以下模板建構:
<html ng-app>
<head>
...
<script src="lib/angular/angular.js"></script>
<script src="js/controllers.js"></script>
</head>
<body ng-controller="PhoneListCtrl">
<ul>
<li ng-repeat="phone in phones">
{{phone.name}}
<p>{{phone.snippet}}</p>
</li>
</ul>
</body>
</html>
我們把先前靜態硬寫的手機清單換掉了,因為這裡用 ngRepeat 指令搭配兩個花括號表達式——{{phone.name}} 與 {{phone.snippet}}——就能達到相同效果:
1. <li> 標籤中的 ng-repeat="phone in phones" 是一個 AngularJS 迭代器,它會以第一個 <li> 為模板,為清單中的每支手機各建構一個 <li> 元素。
2. 如步驟 0 所學,包在花括號中的 phone.name 與 phone.snippet 標示著資料綁定。與常數運算不同,這裡的表達式其實是應用資料模型的引用,這些都在 PhoneListCtrl 控制器中設定好了。
在 PhoneListCtrl 控制器中初始化了資料模型(這裡只是一個包含陣列的函式,陣列裡存的是手機資料):
app/js/controllers.js:
function PhoneListCtrl($scope) {
$scope.phones = [
{"name": "Nexus S",
"snippet": "Fast just got faster with Nexus S."},
{"name": "Motorola XOOM™ with Wi-Fi",
"snippet": "The Next, Next Generation tablet."},
{"name": "MOTOROLA XOOM™",
"snippet": "The Next, Next Generation tablet."}
];
}
別看控制器好像沒做什麼事,它其實扮演關鍵角色。透過為資料模型提供語境,控制器讓我們得以在模型與視圖之間建立資料綁定。我們就是這樣把表現層、資料與邏輯串連起來的:
1. PhoneListCtrl 這個控制器方法名稱(位於 controllers.js)與 <body> 中的 ngController 指令值相匹配。
2. 手機資料此時與注入控制器函式的 $scope 相關聯。應用啟動後會建立一個根作用域,而控制器的作用域是根作用域的典型後繼,它對 <body ng-controller="PhoneListCtrl"> 標記內的所有資料綁定都有效。
作用域理論在 AngularJS 中極為重要:作用域可視為模板、模型與控制器協同運作的黏著劑。任何對模型的改動都會即時反映到視圖,任何視圖上的改動也會立刻體現在模型中,兩者始終同步。想更深入理解,可參考 AngularJS 作用域文件。
「AngularJS 風格」讓開發階段的測試變得十分容易。來看看為控制器新加的單元測試:
test/unit/controllersSpec.js:
describe('PhoneCat controllers', function() {
describe('PhoneListCtrl', function(){
it('should create "phones" model with 3 phones', function() {
var scope = {},
ctrl = new PhoneListCtrl(scope);
expect(scope.phones.length).toBe(3);
});
});
});
這個測試驗證手機陣列裡有三筆記錄。由此可見,為 AngularJS 程式碼建立單元測試是多麼容易。正因為測試在軟體開發中不可或缺,AngularJS 特別讓測試變得輕鬆,藉此鼓勵開發者多寫測試。AngularJS 開發者傾向使用 Jasmine 行為驅動開發(BDD)框架的語法;雖然 AngularJS 並未強制,但本教學所有測試都以 Jasmine 撰寫,你可以在 Jasmine 官網或 Wiki 取得相關知識。
基於 AngularJS 的專案預先配置為使用 JsTestDriver 運行單元測試。你可以這樣執行:
1. 另開一個終端,進入 angular-phonecat 目錄並執行 ./scripts/test-server.sh 啟動測試(Windows 命令列請輸入 .\scripts\test-server.bat,後續腳本命令用法類似)。
2. 開啟一個新的瀏覽器視窗,前往 https://localhost:9876。
3. 選擇「Capture this browser in strict mode」。
接著你就可以放著不管了,JsTestDriver 會自行跑完測試並把結果輸出到終端。
4. 執行 ./scripts/test.sh 進行測試。
你應該會看到類似以下的結果:
Chrome: Runner reset.
.
Total 1 tests (Passed: 1; Fails: 0; Errors: 0) (2.00 ms)
Chrome 19.0.1084.36 Mac OS: Run 1 tests (Passed: 1; Fails: 0; Errors 0) (2.00 ms)
耶!測試通過了!如果執行後發生錯誤,請關掉瀏覽器、回到終端關閉腳本,然後重跑一次上面的步驟。
為 index.html 加入另一個資料綁定,例如:
<p>Total number of phones: {{phones.length}}</p>
建立一個新的資料模型屬性並綁定到模板上,例如 $scope.hello = "Hello, World!",更新瀏覽器確認畫面顯示出「Hello, World!」。也可以試著用迭代器做一個簡單的表格:
<table>
<tr><th>row number</th></tr>
<tr ng-repeat="i in [0, 1, 2, 3, 4, 5, 6, 7]"><td>{{i+1}}</td></tr>
</table>
最後,把單元測試中的 toBe(3) 改成 toBe(4),重跑 ./scripts/test.sh,確認測試會如預期失敗。
你現在擁有一個模型、視圖、控制器分離的動態應用,而且隨時都能測試。接下來就進入步驟 3,為應用加入全文檢索功能吧!