AngularJS 的 HTML 編譯器能讓瀏覽器識別全新的 HTML 語法。它讓你能把行為關聯到 HTML 元素或屬性上,甚至創造具備自訂行為的新元素。AngularJS 把這種行為擴充稱為「指令(directive)」。
HTML 在撰寫靜態頁面時,提供了許多宣告式結構來控制格式。舉例來說,要把某段內容置中,你不必告訴瀏覽器「先找出視窗中點,再讓內容中點與之對齊」,只要加上 align="center" 屬性即可——這就是宣告式語言的強大之處。
但宣告式語言也有力所不及的地方:你無法用它教會瀏覽器新的語法。比如你想讓內容靠左對齊到三分之一處,它就辦不到了。因此我們需要一個方法,讓瀏覽器能學會新的 HTML 語法。
AngularJS 本身就內建了一些對開發應用非常有用的指令,我們也鼓勵你為自己的應用打造專屬指令。這些擴充出來的指令,就成了你建構應用的「特定領域語言(Domain Specific Language)」。整個編譯過程都在瀏覽器端發生,伺服器端不會參與任何步驟,也不做預編譯。
編譯器是 AngularJS 提供的一項服務,它會遍歷 DOM 以找出相關的屬性。整個編譯過程分為兩個階段:
1. 編譯:遍歷 DOM 並收集所有相關指令,產生一個連結函式。
2. 連結:為指令綁定一個作用域,生成動態視圖。作用域模型的任何變化都會反映到視圖上,視圖上的任何用戶操作也會反映回作用域模型,讓作用域模型成為你業務邏輯裡唯一需要關注的東西。
有些指令(例如 ng-repeat)會為資料集合中的每一項各複製一份 DOM 元素。把整個過程拆成「編譯」與「連結」兩階段,能改善整體效能,因為複製出來的模板只需編譯一次,之後各自連結到自己的模型實例即可。
指令描述的是「當相關的 HTML 結構進入編譯階段時應執行的操作」。指令可以寫在元素名稱、屬性、CSS 類名,甚至註釋裡。以下是幾個功能相同、寫法不同的 ng-bind 指令範例:
<span ng-bind="exp"></span>
<span class="ng-bind: exp;"></span>
<ng-bind></ng-bind>
<!-- directive: ng-bind exp -->
指令在本質上只是一個函式,當編譯器編譯到相關 DOM 時便會執行它。更詳盡的說明可查閱指令 API 文件。
下面這個指令能讓元素變得可以拖曳,請留意 <span> 中的 draggable 屬性。
index.html:
<!doctype html>
<html ng-app="drag">
<head>
<script src="https://code.angularjs.org/angular-1.1.0.min.js"></script>
<script src="script.js"></script>
</head>
<body>
<span draggable>Drag ME</span>
</body>
</html>
script.js:
angular.module('drag', []).
directive('draggable', function($document) {
var startX = 0, startY = 0, x = 0, y = 0;
return function(scope, element, attr) {
element.css({
position: 'relative',
border: '1px solid red',
backgroundColor: 'lightgrey',
cursor: 'pointer'
});
element.bind('mousedown', function(event) {
startX = event.screenX - x;
startY = event.screenY - y;
$document.bind('mousemove', mousemove);
$document.bind('mouseup', mouseup);
});
function mousemove(event) {
y = event.screenY - startY;
x = event.screenX - startX;
element.css({
top: y + 'px',
left: x + 'px'
});
}
function mouseup() {
$document.unbind('mousemove', mousemove);
$document.unbind('mouseup', mouseup);
}
}
});
只要加上 draggable 屬性,任何 HTML 元素都能獲得這個新行為。這種做法的優美之處在於:我們用一種開發者熟悉 HTML 規則就會覺得很自然的方式,賦予了瀏覽器理解新語法的能力。
網路上有許多模板系統,它們大多採用「把靜態字串模板與資料綁定,生成新字串,再透過 innerHTML 插入頁面元素」的做法。這代表資料一旦改變,就得重新把資料與模板結合、生成新字串、再塞回 DOM。其中會遇到的問題包括:需要讀取用戶輸入並與模型資料結合、需要覆寫用戶輸入、需要手動管理整個更新流程,以及表現力不足。
AngularJS 則截然不同:它的編譯器使用的是「帶指令的 DOM」,而非字串模板。它會回傳一個連結函式,與作用域模型結合後生成動態視圖,這個視圖與模型的綁定過程是「透明」的——開發者無須做任何更新視圖的工作。由於全程不用到 innerHTML,我們也就不必覆寫用戶輸入。更特別的是,Angular 的指令不僅能用字串形式的綁定,還能使用一些指示行為的結構體。
AngularJS 的編譯會生成一個「穩定的 DOM」,代表綁定了資料模型的 DOM 元素實例不會在綁定的生命週期內改變。這也意味著你可以在程式碼中取得 DOM 元素的實例引用並註冊事件,不必擔心這個引用會在模板與資料結合時遺失。