緊接上篇“AngularJS 初步認識”http://www.linuxidc.com/Linux/2016-08/134158.htm
一、前言在AngularJS中指令尤為重要且內容龐多,固單獨提煉出來,梳理一番。如有錯誤,請不吝講解。
好了,言歸正傳,讓我們一起走進Angular指令的世界。
在上篇文章的前言部分提到,Angular的核心就是對HTML標簽的增強。我們用到的諸如ng-app、ng-controller等等這些都是屬於Angular指令,具體點,它們為Angular內置的指令。
Angular不僅提供了內置指令,它還允許我們自定義指令,不然Angular就太low咯。
這也是本篇文章的核心:如何自定義指令。
二、自定義指令Angular為我們提供了.directive()這個方法,來定義指令。
如下:
正如上述代碼所示,directive方法接受兩個參數:name和factory_function。
--name嘛,即為指令的名字,供我們調用時使用;
--factory_function就是當我們調用指令時,指令的實際行為,並且factory_function通常返回一個對象,裡面通過規定的設置項來定義指令。
那麼自定義指令中,我們都可以操作哪些設置項呢?
如下:
var app = angular.module('myApp', []); app.directive('myDirective', function(){ return { restrict: 'EACM',//告訴AngularJS這個指令在DOM中以何種形式被聲明,默認為A priority: Number,//優先級參數(值為數值),數值越大,優先級越高,默認為0 terminal: Boolean,//true或者false,告訴AngularJS是(true)否(false)停止運行當前元素上比本指令優先級低的指令 template: String or Template Function,//模板 templateUrl: String,//模板URL replace: Boolean,//值為true,代表模板會替換掉調用該指令的元素 scope: Boolean or Object,//指令作用域 transclude: Boolean,//true,結合ng-transclude,在該指令中嵌入內容 controller: String or function($scope, $element, $attrs, $transclude, otherInjectables){...},//指令控制器 controllerAs: String,//用來設置控制器的別名 require: String,//將控制器注入到其值所指定的指令中 link: function(scope, element, attrs){...}, compile: function(){} }; });代碼稍長,請自行打開
針對如此眾多的設置項,我們一同先挑幾個常用且簡單的設置項,感受感受吧。
--template & templateUrl--
template模板參數是可選的,其值可以是一段HTML文本,也可以是一個接受兩個參數的函數。
注:如果template值為空,或者沒有template設置項,那麼不會覆蓋嵌入在指令內部的元素,且當指令scope為false或者{…}時,內部元素的作用域共享外部父作用域;但,當指令scope為true時,內部元素的作用域就是繼承自外部父作用域。
demo如下:
<!DOCTYPE html> <head> <meta charset="utf-8"/> </head> <body ng-app="myModule"> outterDirective:<input type="text" ng-model="name"/><br> <one> innerDirective: <input type="text" ng-model="name"/> </one> <script src="angular.js"></script> <script> var myModule = angular.module('myModule', []); myModule.directive('one', function(){ return { scope: false, restrict: 'E' } }); </script> </body> </html>scope為false
效果圖如下:
<!DOCTYPE html> <head> <meta charset="utf-8"/> </head> <body ng-app="myModule"> outterDirective:<input type="text" ng-model="name"/><br> <one> innerDirective: <input type="text" ng-model="name"/> </one> <script src="angular.js"></script> <script> var myModule = angular.module('myModule', []); myModule.directive('one', function(){ return { scope: {}, restrict: 'E' } }); </script> </body> </html>scope為{...}
scope:{...}效果同上
<!DOCTYPE html> <head> <meta charset="utf-8"/> </head> <body ng-app="myModule"> outterDirective:<input type="text" ng-model="name"/><br> <one> innerDirective: <input type="text" ng-model="name"/> </one> <script src="angular.js"></script> <script> var myModule = angular.module('myModule', []); myModule.directive('one', function(){ return { scope: true, restrict: 'E' } }); </script> </body> </html>scope為true
scope為true,效果圖如下:
假設,設置了template後,當我們調用指令後,它會呈現在頁面中。下面我們就來具體看看。
1、當template值為一段HTML文本時,demo如下:
<!DOCTYPE html> <head> <meta charset="utf-8"/> </head> <body ng-app="myApp"> <div my-directive></div> <script src="angular.js"></script> <script> var app = angular.module('myApp', []); app.directive('myDirective', function(){ return { template: '<div>\ <h1>Hi everyone!</h1>\ </div>' }; }); </script> </body> </html>EntireCode
2、當template值為函數時,demo如下:
<!DOCTYPE html> <head> <meta charset="utf-8"/> </head> <body ng-app="myApp"> <div my-directive title="Monkey"></div> <script src="angular.js"></script> <script> var app = angular.module('myApp', []); app.directive('myDirective', function(){ return { /* 值為函數時,接受兩個參數tElement, tAttrs: tElement:使用此指令的元素 tAttrs:實例的屬性,它是一個由元素上所有的屬性組成的集合,即對象 */ template: function(tElement, tAttrs){ var _html = ''; _html +='<div>' + 'Hi,'+tAttrs.title+'</div>'; return _html; } }; }); </script> </body> </html>代碼稍長,請自行打開
利用template可以在指令中自定義我們需要的模板,但是隨著模板的體積(代碼量)不斷變大時,在指令中利用template就顯得很糟糕,故而,使用templateUrl引用外部模板,是更好的選擇。
--restrict--
restrict 是一個可選參數,它告訴AngularJS這個指令在DOM中以何種形式被調用。一共有四個選擇且都為大寫,不然沒效果,默認為A(屬性)。
A(屬性):
<div my-directive></div>
E(元素):
<my-directive></my-directive>
C(類名):
<div class="my-directive"></div>
M(注釋):
//以注釋調用指令時,前後得有空格 <!-- directive:my-directive -->
這四個選項,可以單獨使用,亦可混合使用。如:
restrict: ‘EA’就代表可以用元素或者屬性調用指令
--replace--
replace是一個可選參數,值為Boolean類型,默認為false,代表模板會被當作子元素插入到調用此指令的元素內部。
如下:
<!DOCTYPE html> <head> <meta charset="utf-8"/> </head> <body ng-app="myApp"> <div my-directive></div> <script src="angular.js"></script> <script> var app = angular.module('myApp', []); app.directive('myDirective', function(){ return { replace: false, template: '<div>Monkey</div>' }; }); </script> </body> </html>代碼稍長,請自行打開
運行後,打開chrome調試器,結果如下:
--replace值為true,即模板會替換掉調用指令的元素,如下:
<!DOCTYPE html> <head> <meta charset="utf-8"/> </head> <body ng-app="myApp"> <div my-directive></div> <script src="angular.js"></script> <script> var app = angular.module('myApp', []); app.directive('myDirective', function(){ return { replace: true, template: '<div>Monkey</div>' }; }); </script> </body> </html>代碼稍長,請自行打開
運行後,打開chrome調試器,結果如下:
且,當值為true時,template會替代調用指令的元素,固template中的值,必須只包含一個根節點,不然會報錯,如下:
<!DOCTYPE html> <head> <meta charset="utf-8"/> </head> <body ng-app="myApp"> <div my-directive></div> <script src="angular.js"></script> <script> var app = angular.module('myApp', []); app.directive('myDirective', function(){ return { replace: true, template: '<div>Monkey</div><h1>Dorie</h1>' }; }); </script> </body> </html>代碼稍長,請自行打開
運行後,打開chrome調試器,報錯如下:
--transclude--
transclude是一個可選參數,表示是否允許在指令中,嵌入內容。值為Boolean,默認值為false代表不允許在指令中嵌入內容,如果手動設置為true後,要結合ng-transclude指令使用,不然和false效果一樣。
下面我們一起來編寫兩個demo具體看看。
<!DOCTYPE html> <head> <meta charset="utf-8"/> </head> <body ng-app="myApp"> <div my-directive> <span>需要嵌入內容</span> </div> <script src="angular.js"></script> <script> var app = angular.module('myApp', []); app.directive('myDirective', function(){ return { transclude: false, template: '<div>指令內容</div>' }; }); </script> </body> </html>transclude為false
運行代碼,打開chrome調試器得下:
我們再來看看transclude:true的情況,將上述代碼中的transclude的值改為true後,運行代碼。
咦,我靠和上訴transclude:false的結果一樣呢?
哦,對了,雖然我們將transclude的值設為true了,但是要結合ng-transclude指令嘛,不然,你讓人家嵌入內容往哪插呢?
利用ng-transclude指令修改代碼後,得下:
<!DOCTYPE html> <head> <meta charset="utf-8"/> </head> <body ng-app="myApp"> <div my-directive> <span>需要嵌入內容</span> </div> <script src="angular.js"></script> <script> var app = angular.module('myApp', []); app.directive('myDirective', function(){ return { transclude: true, template: '<div>指令內容</div><div ng-transclude></div>' }; }); </script> </body> </html>代碼稍長,請自行打開
運行代碼,打開chrome調試器,得下:
注:利用ng-transclude指令標記的元素中,不管有沒有內容,都將等同於無內容情況。
咦,利用transclude嵌入的內容,它們有自己的作用域嗎?如果有,那麼它們的作用域繼承誰呢,指令or外部作用域?
答案:利用ng-transclude嵌入的內容的同時,會創建一個屬於自己的作用域,即子作用域,且繼承自外部作用域,並非指令。
--scope--
scope參數是可選的,它是直接影響指令的作用域。該參數可以被設置為不同的三個值,分別代表三種不同的作用域,下面我們就來一一說明。
1、scope: false
當scope的值為false時,也就是默認狀態,代表指令共享父作用域,即沒有自己的作用域。
如下:
<!DOCTYPE html> <head> <meta charset="utf-8"/> </head> <body ng-app="myApp"> Parent:<input type="text" ng-model="name"/> <directive-for-false></directive-for-false> <script src="angular.js"></script> <script> var app = angular.module('myApp', []); app.directive('directiveForFalse', function(){ return { restrict: 'E', scope: false, template: '<div>Child: \ <input type="text" ng-model="name">\ </div>' }; }); </script> </body> </html>代碼稍長,請自行打開
執行上述代碼,效果圖如下:
2、scope: true
當scope的值為true時,代表指令會創建自己的作用域,且繼承自父作用域。
如下:
<!DOCTYPE html> <head> <meta charset="utf-8"/> </head> <body ng-app="myApp"> Parent:<input type="text" ng-model="name"/> <directive-for-true></directive-for-true> <script src="angular.js"></script> <script> var app = angular.module('myApp', []); app.directive('directiveForTrue', function(){ return { restrict: 'E', scope: true, template: '<div>Child: \ <input type="text" ng-model="name">\ </div>' }; }); </script> </body> </html>代碼稍長,請自行打開
執行上述代碼,效果圖如下:
3、scope: {…}
當scope的值為對象時,代表指令會切斷與外界的聯系,創建一個隔離的作用域,既不繼承於父作用域,也不准內嵌的指令繼承於自己。
一起寫個demo,感受下“隔離作用域”不繼承於父作用域,如下:
<!DOCTYPE html> <head> <meta charset="utf-8"/> </head> <body ng-app="myApp"> Parent:<input type="text" ng-model="name"/> <directive-for-obj></directive-for-obj> <script src="angular.js"></script> <script> var app = angular.module('myApp', []); app.directive('directiveForObj', function(){ return { restrict: 'E', scope: {}, template: '<div>Child: \ <input type="text" ng-model="name">\ </div>' }; }); </script> </body> </html>
執行上述代碼,效果圖如下:
至於“不准內嵌的指令繼承於自己”,參考上面的--transclude--
那當我們將scope設置為對象後,就成了一個無人問津的作用域,這樣非常適合我們寫插件之類的,但,怎麼與外界交互呢?
這就涉及到所謂的綁定策略啦。
如下:
scope的綁定策略
@
把當前屬性作為字符串傳遞。你還可以綁定來自外層scope的值,在屬性值中插入{{ }}即可。
=
與父scope中的屬性進行雙向綁定。
&
傳遞一個來自父scope的函數
下面,我們就針對上面的提示,逐個demo,感受體會下。
1、@策略
<!DOCTYPE html> <head> <meta charset="utf-8"/> </head> <body ng-app="myApp"> <input type="text" ng-model="name"/> <directive-for-obj who="{{name}}" love="love Dorie"></directive-for-obj> <script src="angular.js"></script> <script> var app = angular.module('myApp', []); app.directive('directiveForObj', function(){ return { restrict: 'E', scope: { who:'@', what: '@love' }, template: '<div><input type="text" ng-model="who"/> {{what}}</div>' }; }); </script> </body> </html>代碼稍長,請自行打開
效果圖,如下:
2、=策略
<!DOCTYPE html> <head> <meta charset="utf-8"/> </head> <body ng-app="myApp"> <input type="text" ng-model="name"/> <directive-for-obj who="name" love="love Dorie"></directive-for-obj> <script src="angular.js"></script> <script> var app = angular.module('myApp', []); app.directive('directiveForObj', function(){ return { restrict: 'E', scope: { who:'=', what: '@love' }, template: '<div><input type="text" ng-model="who"/> {{what}}</div>' }; }); </script> </body> </html>代碼稍長,請自行打開
效果圖,如下:
3、&策略
<!DOCTYPE html> <head> <meta charset="utf-8"/> </head> <body ng-app="myApp"> <input type="text" ng-model="name"/> <directive-for-obj who="name" love="love Dorie" greet="sayWhat(wt, whr)"></directive-for-obj> <script src="angular.js"></script> <script> var app = angular.module('myApp', []); app.run(function($rootScope){ $rootScope.sayWhat = function(what, where){ alert('hello, '+what+' at '+where); } }); app.directive('directiveForObj', function(){ return { restrict: 'E', scope: { who:'=', what: '@love', greet: '&' }, template: '<div><input type="text" ng-model="who"/> {{what}}</div>\ <button ng-click="greet({wt: who, whr: who})">click</button>' }; }); </script> </body> </html>EntireCode
--controller--
controller參數可以是一個字符串或一個函數。
注:當設置為字符串時,會以該字符串的值為名字,到注冊在應用中的控制器中查找,不管該指令的scope值是什麼,如果應用中的控制器沒有對應的控制器,則報錯。
在控制器中,是的,控制器,包括了指令以及注冊在應用中的,可以注入一些特殊的服務,供其使用,如下:
$scope
與指令元素相關聯的當前作用域
$element
當前指令對應的元素
$attrs
當前元素的屬性組成的對象,如:
<div id=”nav” name=”Monkey”></div>
屬性對象為:
{
id: ‘nav’,
name: ‘Monkey’
}
並且,指令之間的控制器(controller)可以復用。
怎麼復用呢?
這就需要結合下面將要介紹的require設置項啦。
--require--
require參數可以被設置為字符串或數組,字符串代表另外一個指令的名字。Require會將控制器注入到其值所指定的指令中,並作為當前指令的鏈接函數(link)的第四個參數。用法如下:
沒有前綴
指令會在自身提供的控制器中進行查找,如果找不到任何控制器,則會拋出一個error
?
如果在當前的指令沒有找到所需的控制器,則會將null傳給link連接函數的第四個參數
^
如果在當前的指令沒有找到所需的控制器,則會查找父元素的控制器
?^
綜合前面?和^
一些AngularJS相關文章鏈接:
AngularJS權威教程 清晰PDF版 http://www.linuxidc.com/Linux/2015-01/111429.htm
希望你喜歡,並分享我的工作~帶你走近AngularJS系列:
如何在 AngularJS 中對控制器進行單元測試 http://www.linuxidc.com/Linux/2013-12/94166.htm
在 AngularJS 應用中通過 JSON 文件來設置狀態 http://www.linuxidc.com/Linux/2014-07/104083.htm
AngularJS 之 Factory vs Service vs Provider http://www.linuxidc.com/Linux/2014-05/101475.htm
AngularJS —— 使用 ngResource、RESTful APIs 和 Spring MVC 框架提交數據 http://www.linuxidc.com/Linux/2014-07/104402.htm
AngularJS 的詳細介紹:請點這裡
AngularJS 的下載地址:請點這裡