Angular中定義了很多內(nèi)部指令,顯著標(biāo)志就是以ng-XXX開(kāi)頭或链,但有的時(shí)候?yàn)榱藢?shí)現(xiàn)特定的功能兜材,只使用內(nèi)部指令是遠(yuǎn)遠(yuǎn)不能滿足我們需求的,這時(shí)候自定義指令就顯得尤為重要
內(nèi)部指令就不多說(shuō)了纫雁,下面是關(guān)于自定義指令需要注意的地方煌往,有不對(duì)的地方歡迎指正。
舉個(gè)自定義指令寫(xiě)法的栗子:
angular.module('myApp', [])
.directive('myDirective',function(){
return {
restrict:'E',
template:'<button>點(diǎn)擊</button>'
}
})
講解栗子:
- 我們可以直接使用Angular中的
directive()
這個(gè)方法定義了一個(gè)新的指令 - 參數(shù)1轧邪,是指令名稱(chēng)刽脖,上面定義了一個(gè)my-directive的指令
- 參數(shù)2,是對(duì)參數(shù)1也就是剛剛自定義指令的說(shuō)明忌愚,可以直接是一個(gè)
function(){//相應(yīng)的代碼}
曲管,也可以是一個(gè)函數(shù)名
,但這個(gè)函數(shù)需要在下面定義,推薦第二種寫(xiě)法硕糊; - 參數(shù)2返回的是參數(shù)1這個(gè)指令對(duì)應(yīng)的對(duì)象院水,它包括以下幾點(diǎn):
restrict[string]這個(gè)屬性,主要是用來(lái)規(guī)定指令在HTML代碼中可以使用什么表現(xiàn)形式简十。
- E代表元素(element)
- A代表屬性(attribute)
- C代表類(lèi)(class)
- M代表注釋?zhuān)╟ommon)
推薦項(xiàng)目中使用EA這兩種寫(xiě)法檬某,一般我們也就使用EA比較多。
- E---> 作為一個(gè)HTML元素來(lái)使用
<my-directive></my-directive>或者<my-directive/>
- A ----> 作為元素的屬性來(lái)使用
<div my-directive></div>
- C--->作為一個(gè)元素的類(lèi)來(lái)使用
<div class="my-directive"></div>
- M---> 作為注釋來(lái)使用
需要注意的是:
- 使用注釋這種方式有個(gè)很隱秘的坑螟蝙,比如:
directive: my-directive
這個(gè)的后面要有一個(gè)空格恢恼,切記,不然寫(xiě)了也是白寫(xiě)胰默; -
不推薦
使用這種寫(xiě)法场斑,一般項(xiàng)目也不使用注釋這種方式漓踢;
template[string or function]這個(gè)屬性,規(guī)定了指令被Angular編譯和鏈接(link)后生成的HTML標(biāo)記和簸,這個(gè)屬性可以簡(jiǎn)單到只有一個(gè)HTML文本在里面彭雾,也可以特別復(fù)雜,當(dāng)該屬性的值為function的時(shí)候锁保,那么該方法返回的就是代表模板的字符串薯酝,同時(shí)也可以在里面使用{{}}這個(gè)表達(dá)式。
但是在一般情況下爽柒,template這個(gè)屬性都會(huì)被templateUrl取代掉吴菠,用它來(lái)指向一個(gè)外部的文件地址,所以我們通常把模板放在外部的一個(gè)HTML文件中浩村,然后使用templateUrl來(lái)指向他做葵。
priority[number]屬性,這個(gè)屬性是來(lái)規(guī)定自定義的指令的優(yōu)先級(jí)的
當(dāng)一個(gè)DOM元素上面有一個(gè)以上的指令的時(shí)候心墅,就需要去比較指令的優(yōu)先級(jí)了酿矢,優(yōu)先級(jí)高的指令先執(zhí)行。這個(gè)優(yōu)先級(jí)就是用來(lái)在執(zhí)行指令的compile函數(shù)前怎燥,先排序的
terminal[boolean]屬性瘫筐,該參數(shù)用來(lái)定義是否停止當(dāng)前元素上比本指令優(yōu)先級(jí)低的指令
如果值為true,就是正常情況铐姚,按照優(yōu)先級(jí)高低的順序來(lái)執(zhí)行策肝,如果設(shè)置為false,就不會(huì)執(zhí)行當(dāng)前元素上比本指令優(yōu)先級(jí)低的指令隐绵。
replace[boolean]屬性之众,這個(gè)屬性用來(lái)規(guī)定生成的HTML內(nèi)容是否會(huì)替換掉定義此指令的HTML元素。
當(dāng)我們把該屬性的值設(shè)為true的時(shí)候依许,打開(kāi)控制臺(tái)看看你會(huì)發(fā)現(xiàn)這個(gè)指令生成的元素會(huì)是這樣的:
<button>點(diǎn)擊</button>
當(dāng)值為false時(shí)為:
<my-directive>
<button>點(diǎn)擊</button>
</my-directive>
link[function]屬性棺禾,在上面的例子中,我們自定義的指令其實(shí)沒(méi)有多大意義峭跳,這只是一個(gè)最簡(jiǎn)單的指令膘婶,有好多的屬性我們都沒(méi)有為他定義,所以沒(méi)有多大用途坦康。
比如這個(gè)link函數(shù)竣付,它包括三個(gè)參數(shù):scope诡延、element滞欠、attrs。這個(gè)link函數(shù)主要是用來(lái)添加對(duì)DOM元素的事件監(jiān)聽(tīng)肆良、監(jiān)視模型屬性變化筛璧、以及更新DOM的逸绎。它里面三個(gè)參數(shù):
scope參數(shù),在我們沒(méi)有為指令定義scope屬性的時(shí)候夭谤,那么他代表的就是父controller的scope棺牧。
element參數(shù),就是指令的jQLite(jQuery的子集)包裝DOM元素朗儒。如果你在引入AngularJS之前引入了jQuery颊乘,那么這個(gè)元素就是jQuery元素,而不是jQLite元素醉锄。由于這個(gè)元素已經(jīng)被jQuery/jQLite包裝了乏悄,所以我們就在進(jìn)行DOM操作的時(shí)候就不需要再使用 $()來(lái)進(jìn)行包裝。
attrs參數(shù)恳不,它包含了該指令所在元素的屬性的標(biāo)準(zhǔn)化參數(shù)對(duì)象檩小。