AngularJS 沒有 main 方法。它用「模組」來宣告應用該如何啟動,這個設計決定了整個框架的組織方式。本文從 AngularJS 的定位談起,深入說明模組的構成、載入規則與實務上的拆分策略。
AngularJS 是一套純客戶端技術,完全以 JavaScript 撰寫,使用的仍是網頁開發的常規技術(HTML、CSS、JavaScript),目標是讓網頁應用開發更快更容易。
它簡化開發的核心手法,是把通用的低階操作包裝起來交給框架處理,包括:
因為這些瑣事被自動處理,開發者能把注意力放在業務邏輯上,少寫大量重複、易錯、低階的程式碼。
同時,它為客戶端帶來了一些精巧的技術:資料、業務邏輯與視圖的分離;資料與視圖的自動綁定;通用服務;依賴注入(主要用於聚合服務);可擴充的 HTML 編譯器(完全由 JavaScript 編寫);以及良好的可測試性。
AngularJS 可以用來開發單頁或多頁應用,但主要還是針對單頁應用設計。它支援瀏覽器歷史操作——向前、向後按鈕,以及單頁應用中的收藏行為。
大部分應用都有一個主方法用來實例化、組織並啟動應用。AngularJS 改用模組來聲明啟動方式,帶來幾個好處:
<!doctype html>
<html ng-app="myApp">
<head>
<script src="angular.min.js"></script>
<script>
var myAppModule = angular.module('myApp', []);
// 在這個模組中註冊一個名為 greet 的過濾器
myAppModule.filter('greet', function () {
return function (name) {
return 'Hello, ' + name + '!';
};
});
</script>
</head>
<body>
<div>{{ 'World' | greet }}</div>
</body>
</html>
這裡透過 <html ng-app="myApp"> 指定要啟動的模組,Angular 便以此為入口完成 bootstrap。
上面的寫法雖簡單,但不適合大型應用。建議拆成四類模組:
HTML:
<!doctype html>
<html ng-app="xmpl">
<head>
<script src="angular.min.js"></script>
<script src="script.js"></script>
</head>
<body>
<div ng-controller="XmplController">{{ greeting }}!</div>
</body>
</html>
script.js:
// 服務模組
angular.module('xmpl.service', [])
.value('greeter', { // 自訂 greeter 物件
salutation: 'Hello',
localize: function (localization) {
this.salutation = localization.salutation;
},
greet: function (name) {
return this.salutation + ' ' + name + '!';
}
})
.value('user', { // 自訂 user 物件
load: function (name) { this.name = name; }
});
// 指令模組
angular.module('xmpl.directive', []);
// 過濾器模組
angular.module('xmpl.filter', []);
// 應用級模組:依賴上述三者
angular.module('xmpl', ['xmpl.service', 'xmpl.directive', 'xmpl.filter'])
.run(function (greeter, user) {
// 初始化程式碼,應用啟動時自動執行
greeter.localize({ salutation: 'Bonjour' });
user.load('World');
});
// 應用的 Controller
var XmplController = function ($scope, greeter, user) {
$scope.greeting = greeter.greet(user.name);
};
這樣拆分的原因是:測試時往往需要忽略初始化程式碼,因為那類程式碼較難測試。把它獨立成一個模組,測試時就能直接不載入。同時,只載入與當前測試相關的模組,也能讓測試更專注。這只是一個建議,可依實際情況調整。
一個模組就是一系列配置與程式碼塊的集合,在啟動階段附加到應用上。最簡單的模組由兩類程式碼塊組成:
配置塊(config block) — 在 provider 注入與配置階段執行。只有 provider 與常數可以被注入。這是為了防止服務在被配置好之前就被提前初始化。
執行塊(run block) — 在注入器建立之後執行,用來啟動應用。只有實例與常數可以被注入。這是為了防止系統啟動後還出現配置行為。
angular.module('myModule', [])
.config(function (injectables) {
// 配置塊:只能注入 Provider,不能注入實例
})
.run(function (injectables) {
// 執行塊:只能注入實例,不能注入 Provider
});
模組提供了一些簡便方法,效果等同於使用程式碼塊:
angular.module('myModule', [])
.value('a', 123)
.factory('a', function () { return 123; })
.directive('directiveName', ...)
.filter('filterName', ...);
// 等同於
angular.module('myModule', [])
.config(function ($provide, $compileProvider, $filterProvider) {
$provide.value('a', 123);
$provide.factory('a', function () { return 123; });
$compileProvider.directive('directiveName', ...);
$filterProvider.register('filterName', ...);
});
配置塊會依 $provide → $compileProvider → $filterProvider 的順序被套用。唯一的例外是常數的定義應該永遠放在配置塊的開頭,因為其他配置可能依賴它。
執行塊是 AngularJS 中最接近主方法的東西。它是一段用來啟動應用的程式碼,在所有服務都配置完成、所有注入器都建立之後執行。
執行塊通常包含一些難以測試的程式碼,因此應該寫在獨立的模組裡,這樣單元測試時就能忽略它們。這正是第四節把初始化程式碼獨立成應用級模組的原因。
模組可以把其他模組列為依賴。「依賴某個模組」意味著該被依賴的模組必須先被載入。也就是說,被依賴模組的配置塊會在本模組配置塊之前執行,執行塊同理。
兩個重要規則:任何模組只能被載入一次,即使它被多個模組依賴;以及模組機制與腳本載入無關——它管理的是 $injector 的配置。網路上已有許多控制腳本載入的函式庫可以與 AngularJS 搭配使用,因為載入期間模組不做任何事,所以腳本可以按任意順序或平行方式載入。
值得補充的是,AngularJS 1.x 已被官方終止維護,後續的 Angular 2+ 是完全重寫,模組概念改由 ES Module 與 NgModule 共同承擔,依賴注入也改為以型別為基礎建構。不過這篇文章的核心觀念——把配置與啟動分離、透過宣告式方式定義元件、依賴關係決定執行順序——在現代前端框架中依然通用,只是實作手段不同。理解「為什麼要這樣設計」,比記住 .config() 與 .run() 的差別更有長遠價值。