本節說明 AngularJS 初始化的過程,以及在需要時你該如何調整它的初始化方式。
以下範例展示了我們推薦的整合方式,稱為「自動初始化」:
<!doctype html>
<html xmlns:ng="https://angularjs.org" ng-app>
<body>
...
<script src="angular.js"></script>
</body>
</html>
幾個實務建議:
1. 把 script 標籤放在頁面底部,能縮短應用載入時間,因為這樣 HTML 的載入不會被 angular.js 的載入阻塞。你可以從 https://code.angularjs.org 取得最新版本,但請勿在正式程式碼中直接引用這個網址,以免暴露安全隱患;純粹實驗性質的開發則無妨。其中 angular-[version].js 是可讀版本,適合開發與除錯;angular-[version].min.js 是壓縮混淆後的版本,適合部署到正式產品。
2. 把 ng-app 指令放到應用的根節點。若你想讓 AngularJS 自動處理整個 <html>,就放在 <html> 標籤中:
<html ng-app>
3. 如果你想沿用舊版的 ng: 指令語法,還需在 <html> 中寫入 XML namespace,才能讓 AngularJS 在 IE 下正常運作(這是歷史原因,我們並不建議繼續使用 ng: 語法):
<html xmlns:ng="https://angularjs.org">
AngularJS 會在 DOMContentLoaded 事件觸發時啟動,並透過 ng-app 指令尋找應用的根作用域。一旦找到 ng-app,AngularJS 便會:
1. 載入與指令內容相關的模組。
2. 建立應用的「注入器(injector)」。
3. 以帶有 ng-app 指令的標籤為根節點來編譯其中的 DOM。這也讓你能只把 DOM 的某一部分指定為 AngularJS 應用:
<!doctype html>
<html ng-app="optionalModuleName">
<body>
I can add: {{ 1+2 }}.
<script src="angular.js"></script>
</body>
</html>
如果你需要主動掌控初始化的過程,可以改用手動引導。例如使用「腳本載入器(script loader)」,或需要在 AngularJS 編譯頁面前先做一些處理時,就會用到它。下面的範例示範手動初始化,效果等同於使用 ng-app 指令:
<!doctype html>
<html xmlns:ng="https://angularjs.org">
<body>
Hello {{'World'}}!
<script src="https://code.angularjs.org/angular.js"></script>
<script>
angular.element(document).ready(function() {
angular.bootstrap(document);
});
</script>
</body>
</html>
手動初始化時,你的程式碼必須遵守以下順序:
1. 等頁面與所有腳本載入完畢後,找到 HTML 模板的根節點——通常就是文件的根節點。
2. 呼叫 angular.bootstrap,把模板編譯成可執行、可雙向綁定資料的應用程式。