DIV CSS 佈局教程網

AngularJS 指令系統完全解析:從定義到作用域隔離
編輯:JavaScript基礎知識     

談到 AngularJS,大多數人腦海中浮現的第一印象大概就是雙向資料綁定與指令系統了,這兩者也是這個框架最為迷人的地方。雙向資料綁定沒什麼太多好說的,所以今天我們就來好好聊聊指令系統。本人也還在學習階段,翻查了不少資料,若有講得不周到的地方,還請各位看官多多包容,廢話不多說,我們開始吧。

指令是 AngularJS 中舉足輕重的部分,因此框架本身也內建了不少指令。但在實際開發中,這些內建指令往往無法滿足需求,這時候我們就需要自定義指令了。一個 AngularJS 指令在 HTML 中其實有四種不同的表現形式:

1、作為一個全新的 HTML 元素來使用。

<hello></hello>或者<hello/>

2、作為某個元素的屬性來使用。

<div hello></div>

3、作為某個元素的類來使用。

<div class="hello"</div>

4、作為註釋來使用。

<!--directive: hello -->

這裡有個容易被忽略的陷阱:在 “directive: hello” 後面必須留一個空格,否則是不會生效的。同時也建議盡量少用註釋這種方式,除非你就是想追求一點特立獨行的風格。既然指令有這麼多種表現形式,那麼它究竟該怎麼定義呢?

.directive('hello',function(){ return { restrict:'AECM', template:'<button>click me</button>' } })

上面這段就是定義一個指令最精簡的寫法了。在這段程式碼裡,directive() 方法用來宣告一個新指令,它接收兩個參數:第一個 'hello' 規定了指令的名稱,第二個則是回傳指令物件的函式。而這個函式主要用到了兩個屬性來描述 hello 指令:

1、restrict[string] 屬性,用來規定指令在 HTML 中可以採用哪一種表現形式。A 代表屬性、E 代表元素、C 代表類、M 代表註釋。實務上我們通常只會用到 AE 這兩種。

2、template[string or function] 屬性,規定了指令被 Angular 編譯並鏈接(link)之後所生成的 HTML 標記。這個屬性可以簡單到只有一段 HTML 文字,也可以複雜得多。當它的值是一個 function 時,該方法回傳的就是代表模板的字串,同時還可以在裡面使用 {{}} 表達式。

template: function () { return '<button>click me</button>'; }

不過在一般情況下,template 屬性通常會被 templateUrl 取代,用來指向一個外部檔案的位址。因此我們習慣把模板獨立放在一個 HTML 檔裡,再用 templateUrl 指過去。

除了這兩個最基礎的屬性之外,定義指令時我們還會用到不少其他屬性,下面就逐一說明。

1、priority[number] 屬性,用來規定自定義指令的優先級。當同一個 DOM 元素上掛載了一個以上的指令時,就需要比較它們的優先級,級數高的會先執行。這個優先級是在執行指令的 compile 函式之前用來排序的,關於 compile 函式,我們後面會仔細說明。

2、terminal[boolean] 屬性,用來決定是否停止執行當前元素上優先級比本指令更低的指令。如果設為 true,就按照優先級高低依序執行;若設為 false,則不會執行當前元素上優先級較低的那些指令。

3、replace[boolean] 屬性,用來規定生成的 HTML 內容是否會取代掉定義此指令的那個元素。當我們把它設為 true 時,打開控制台會發現指令生成的元素長這樣:

而設為 false 時則會是這樣:

4、link[function] 屬性。前面那個例子其實沒什麼實際意義,只是最簡單的入門寫法,很多屬性都還沒定義,用途有限。就拿 link 函式來說,它包含三個參數:scope、element、attrs。這個函式主要負責為 DOM 元素掛上事件監聽、監看模型屬性的變化,以及更新 DOM。它裡面的三個參數分別是:

一:scope 參數。如果我們沒有為指令定義 scope 屬性,那麼它代表的就是父層 controller 的 scope。

二:element 參數,就是被 jQLite(jQuery 的子集)包裝過的 DOM 元素。如果你在引入 AngularJS 之前先引入了 jQuery,那麼這個元素就會是 jQuery 元素而非 jQLite 元素。由於它已經被 jQuery/jQLite 包裝過了,所以我們操作 DOM 時不必再用 $() 去包裝一次。

三:attrs 參數,它包含了該指令所在元素所有屬性的標準化參數物件。

5、scope[boolean or object] 屬性,用來定義指令的 scope 範圍,預設是 false,也就是說指令會繼承父層 controller 的 scope,可以隨意使用父 scope 裡的屬性。但這樣做會污染到父 scope 的屬性,並不可取。所以我們可以讓 scope 取 true 或 {} 這兩個值。

當它為 true 時,表示讓 Angular 為這個指令建立一個繼承自父 scope 的 scope。

var myapp=angular.module('myapp',[]) .controller('myctrl',['$scope', function ($scope) { $scope.color='red'; }]) .directive('hello', function () { return{ restrict:'AECM', replace:true, template:'<button ng-click="sayhello()" style="background-color: {{color}}">click me</button>', scope:true, link: function (scope,elements,attrs) { elements.bind('click', function () { elements.css('background-color','blue'); }) } } })

這裡我們為父 scope 定義了一個 color 屬性並賦值為 red,在 hello 指令的 scope 屬性中我們給了 true,於是 Angular 就為這個指令建立了一個繼承自父 scope 的 scope,接著在 template 屬性裡,我們用 {{}} 引用了從父 scope 繼承來的 color 屬性,所以按鈕會是紅色的。

當它為 {} 時,表示建立一個隔離的 scope,不會繼承父 scope 的屬性。但有時候我們仍然需要存取父 scope 裡的屬性或方法,這時該怎麼辦呢?Angular 早就替我們想好了,總共有三種方式可以達到目的:

一:使用 @ 實現單向綁定。如果我們只給 scope 這個 {} 空值,那麼上面程式碼的按鈕背景色會變成灰色。,而當我們需要使用父 scope 的 color 屬性時,可以這樣寫:

scope{ color:'@color' }
<hello color="{{color}}"></hello>

這裡有兩點要留意:1、scope 裡的屬性 color 代表的是模板 {{}} 表達式裡的那個 color,兩者名稱必須一致。2、scope 裡 color 屬性的值,也就是 @ 後面的 color,指的是下方 HTML 元素上的 color 屬性,所以這兩者名稱也必須一致。當元素屬性名與模板 {{}} 裡使用的名稱相同時,就可以省略 @ 後面的屬性名,寫成下面的形式。

scope{ color:'@' }

從指令 scope 的值可以看出,模板表達式 {{}} 裡的 color 指向的是當前元素的 color 屬性,而這個屬性的值又來自父 scope 的 color。父 scope 把 color 的值傳給當前元素的 color 屬性,再由這個屬性傳給模板表達式裡的 color,整個過程是單向的。

二:使用 = 實現雙向綁定。

 .directive('hello', function () { return{ restrict:'AECM', replace:true, template:'<button style="background-color: {{color}}">click me</button>', scope:{ color:'=' }, link: function (scope,elements,attrs) { elements.bind('click', function () { elements.css('background-color','blue'); scope.$apply(function () { scope.color='pink'; }) }) } } })
<hello color="color"></hello> <input type="text" ng-model="color"/>

這裡我們把指令 scope 中的 color 屬性和父 scope 中的 color 屬性做了雙向綁定,並在 link 函式裡加了一個單擊事件:點擊按鈕會改變按鈕顏色,同時改變指令 scope 的 color 值。我們又在頁面上加了一個 input 標籤,用來輸入或輸出父 scope 的 color 值。這裡有兩點要注意:1、當前元素的屬性名(這裡是 color)必須和模板 {{}} 裡的名稱一致。2、當前元素屬性名的值不需要再加上 {{}} 表達式,因為這裡父 scope 傳遞的是真實的 scope 資料模型,而不是單純的字串,所以我們可以傳遞字串、陣列甚至複雜的物件給指令的 scope。現在來看看點擊按鈕會發生什麼。

可以發現按鈕變成了粉色,說明點擊改變了指令 scope 的 color 屬性,進而改變了按鈕顏色。但不只按鈕變了,仔細看,input 表單裡的值也變成了 pink,這就說明父 scope 的 color 也隨之改變了。反過來,我們在 input 裡輸入另一個顏色,看看會發生什麼。

可以看得出,當我們在表單裡輸入另一種顏色時,按鈕顏色也跟著變了,這說明指令 scope 的 color 屬性被同步改變。由此可見,使用 '=' 實現的是雙向綁定。

三:使用 & 呼叫父 scope 裡的方法。

var myapp=angular.module('myapp',[]) .controller('myctrl',['$scope', function ($scope) { $scope.color='red'; $scope.sayhello= function () { alert('hello'); }; }]) .directive('hello', function () { return{ restrict:'AECM', replace:true, template:'<button ng-click="sayhello()" style="background-color: {{color}}">click me</button>', scope:{ color:'=', sayhello:'&' }, link: function (scope,elements,attrs) { elements.bind('click', function () { elements.css('background-color','blue'); scope.$apply(function () { scope.color='pink'; }) }) } } })
<hello color="color" sayhello="sayhello()"></hello> <input type="text" ng-model="color"/>

這裡同樣有兩點要注意:1、我們不僅要在模板裡用 ng-click 綁定要呼叫的父 scope 方法,還要為當前元素加上一個屬性,並讓它指向那個父 scope 方法。2、指令 scope 的屬性 sayhello、當前元素的屬性 sayhello、父 scope 的方法名 sayhello,這三者名稱要一致。這樣一來,點擊按鈕就能彈出一個對話框了。

6、transclude[boolean] 屬性,用來規定指令是否可以包含任意內容。

.directive('hello', function () { return{ restrict:'AECM', replace:true, transclude:true, scope:{}, template:'<div ng-transclude></div>', } })
<hello> hello <span>{{color}}</span> </hello>

當它的值為 true 時,這就是頁面上輸出的內容。當它為 false 時,頁面上將是一片空白。這裡有一點要特別注意,就是 <span>{{color}}</span> 裡的 color 是父 scope 的 color,而不是指令自身 scope 的 color 屬性。

7、compile[function] 參數。這個方法有兩個參數 element 和 attrs,第一個 element 指的是指令所在的元素,第二個 attrs 指的是元素上所有屬性的標準化列表。這裡同樣有個地方要注意:compile 函式無法存取 scope,而且必須回傳一個 link 函式。但如果沒有設定 compile 函式,你就可以正常地配置 link 函式(一旦有了 compile,就不能再用 link,link 函式要由 compile 回傳)。

.directive('hello', function () { return{ restrict:'AECM', replace:true, translude:true, template:'<button ng-click="sayhello()" style="background-color: {{color}}">click me</button>', scope:{ color:'=', sayhello:'&' }, compile: function (element,attrs) { return function (scope,elements,attrs) { elements.bind('click', function () { elements.css('background-color','blue'); scope.$apply(function () { scope.color='pink'; }) }) }; } } })

現在來點擊這個按鈕。

我們會發現,點擊之後發生的事情和前面用 link 屬性的情況一樣,其實並沒有多大意義。

其實在大多數情況下,我們只需要用 link 函式就行了。這是因為絕大部分的指令只需要考慮註冊事件監聽、監看模型以及更新 DOM,而這些都能在 link 函式中完成。但對於像 ng-repeat 這種需要重複克隆 DOM 元素的指令,這份克隆工作會在 link 函式執行之前,由 compile 函式來負責完成。那麼,為什麼需要兩個分開的函式來完成整個生成過程,而不能只用一個呢?要回答這個問題,我們得先理解指令在 Angular 中究竟是如何被編譯的。

8、指令是如何被編譯的。

當我們的 Angular 應用啟動引導時,Angular 會使用 $compile 服務遍歷 DOM 元素,在所有指令都被辨識之後,就會呼叫指令的 compile 方法,回傳一個 link 函式,然後把這個 link 函式加入到稍後要執行的 link 函式列表中,這個過程被稱為編譯階段。像 ng-repeat 這種需要重複克隆許多次的指令,compile 函式只在編譯階段執行一次,用來複製這些模板,但 link 函式則會針對每一個被複製出來的實例各執行一次。把這兩件事分開處理,能在效能上帶來一定的提升。

9、controller[string or function] 與 require[string or string[]] 參數。當我們想讓其他指令能夠和當前指令互動時,就需要用到 controller 函式。而另一個想要互動的指令,則需要透過 require 宣告它對當前指令 controller 實例的引用。

.directive('hello', function () { return{ scope:{}, require:'^he', compile: function (element,attrs) { return function (scope,elements,attrs,cntIns) { cntIns.fn() }; } } }) .directive('he', function () { return { restrict:'AE', scope:{}, controller: function ($scope, $compile, $http) { this.fn= function () { alert('hello'); }; } } })
<he> <hello color="color" sayhello="sayhello()"></hello> </he>

當頁面載入完成之後,就會彈出一個對話框。

好了,以上就是我這段時間學習 Angular 之後,對指令系統所整理出來的心得,就先寫到這裡吧。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved