您好,登錄后才能下訂單哦!
這篇文章將為大家詳細講解有關怎么用AngularJS 指令,文章內容質量較高,因此小編分享給大家做個參考,希望大家閱讀完這篇文章后對相關知識有一定的了解。
指令(Directives)是所有AngularJS應用最重要的部分。盡管AngularJS已經提供了非常豐富的指令,但還是經常需要創建應用特定的指令。這篇教程會為你講述如何自定義指令,以及介紹如何在實際項目中使用。在這篇文章的***(第二部分),我會指導你如何使用Angular指令來創建一個簡單的記事本應用。
概述
一個指令用來引入新的HTML語法。指令是DOM元素上的標記,使元素擁有特定的行為。舉例來說,靜態的HTML不知道如何來創建和展現一個日期選擇器控件。讓HTML能識別這個語法,我們需要使用指令。指令通過某種方法來創建一個能夠支持日期選擇的元素。我們會循序漸進地介紹這是如何實現的。 如果你寫過AngularJS的應用,那么你一定已經使用過指令,不管你有沒有意識到。你肯定已經用過簡單的指令,比如 ng-mode, ng-repeat, ng-show等。這些指令都賦予DOM元素特定的行為。例如,ng-repeat 重復特定的元素,ng-show 有條件地顯示一個元素。如果你想讓一個元素支持拖拽,你也需要創建一個指令來實現它。指令背后基本的想法很簡單。它通過對元素綁定事件監聽或者改變DOM而使HTML擁有真實的交互性。
jQuery視角
想象一下使用jQuery如何創建一個日期選擇器。首先,我們在HTML中添加一個普通的輸入框,然后通過jQuery調用 $(element).dataPicker() 來將它轉變成一個日期選擇器。但是,仔細想一下。當一個設計人員過來檢查HTML標記的時候,他/她能否立刻猜到這個字段實際上表示的內容?這只是一個簡單的輸入框,或者一個日期選擇器?你需要查看jQuery代碼來確定這些。而Angular的方法是使用一個指令來擴展HTML。所以,一個日期選擇器的指令可以是下面的形式:
<input type="text" />
或者是這樣:
<input type="text" />
這種創建UI組建的方式更加直接和清晰。你可以輕易地通過查看元素就明白這到底是什么。
創建自定義指令:
一個Angular指令可以有以下的四種表現形式: 1. 一個新的HTML元素(<data-picker></data-picker>) 2. 元素的屬性(<input type=”text” data-picker/>) 3. CSS class(<input type=”text” class=”data-picker”/>) 4. 注釋(<!–directive:data-picker –>) 當然,我們可以控制我們的指令在HTML中的表現形式。下面我們來看一下AngularJS中的一個典型的指令的寫法。指令注冊的方式與 controller 一樣,但是它返回的是一個擁有指令配置屬性的簡單對象(指令定義對象) 。下面的代碼是一個簡單的 Hello World 指令。
var app = angular.module('myapp', []); app.directive('helloWorld', function() { return { restrict: 'AE', replace: 'true', template: '<h4>Hello World!!</h4>' }; });
在上面的代碼中,app.directive()方法在模塊中注冊了一個新的指令。這個方法的***個參數是這個指令的名字。第二個參數是一個返回指令定義對象的函數。如果你的指令依賴于其他的對象或者服務,比如 $rootScope, $http, 或者$compile,他們可以在這個時間被注入。這個指令在HTML中以一個元素使用,如下:
<hello-world/> //OR <hello:world/>
或者,以一個屬性的方式使用:
<div hello-world></div> //OR <div hello:world/>
如果你想要符合HTML5的規范,你可以在元素前面添加 x- 或者 data-的前綴。所以下面的標記也會匹配 helloWorld 指令:
<div data-hello-world></div> //OR <div x-hello-world></div>
注意: 在匹配指令的時候,Angular會在元素或者屬性的名字中剔除 x- 或者 data- 前綴。 然后將 – 或者 : 連接的字符串轉換成駝峰(camelCase)表現形式,然后再與注冊過的指令進行匹配。這是為什么,我們在HTML中以 hello-world 的方式使用 helloWorld 指令。其實,這跟HTML對標簽和屬性不區分大小寫有關。 盡管上面的指令僅僅實現了靜態文字的顯示,但是這里還是有一些有趣的點值得我們去挖掘。我們在指令定義過程中使用了三個屬性來配置指令。我們來一一介紹他們的作用。
restrict – 這個屬性用來指定指令在HTML中如何使用(還記得之前說的,指令的四種表示方式嗎)。在上面的例子中,我們使用了 ‘AE’。所以這個指令可以被當作新的HTML元素或者屬性來使用。如果要允許指令被當作class來使用,我們將 restrict 設置成 ‘AEC’。
template – 這個屬性規定了指令被Angular編譯和鏈接(link)后生成的HTML標記。這個屬性值不一定要是簡單的字符串。template 可以非常復雜,而且經常包含其他的指令,以及表達式({{ }})等。更多的情況下你可能會見到 templateUrl, 而不是 template。所以,理想情況下,你應該將模板放到一個特定的HTML文件中,然后將 templateUrl 屬性指向它。
replace – 這個屬性指明生成的HTML內容是否會替換掉定義此指令的HTML元素。在我們的例子中,我們用 <hello-world></hello-world>的方式使用我們的指令,并且將 replace 設置成 true。所以,在指令被編譯之后,生成的模板內容替換掉了 <hello-world></hello-world>。最終的輸出是 <h4>Hello World!!</h4>。如果你將 replace 設置成 false,也就是默認值,那么生成的模板會被插入到定義指令的元素中。
打開這個 plunker,在”Hello World!!”右鍵檢查元素內容,來更形象地明白這些。
Link函數和Scope
指令生成出的模板其實沒有太多意義,除非它在特定的scope下編譯。默認情況下,指令并不會創建新的子scope。更多的,它使用父scope。也就是說,如果指令存在于一個controller下,它就會使用這個controller的scope。 如何運用scope,我們要用到一個叫做 link 的函數。它由指令定義對象中的link屬性配置。讓我們來改變一下我們的 helloWorld 指令,當用戶在一個輸入框中輸入一種顏色的名稱時,Hello World 文字的背景色自動發生變化。同時,當用戶在 Hello World 文字上點擊時,背景色變回白色。 相應的HTML標記如下:
<body ng-controller="MainCtrl"> <input type="text" ng-model="color" placeholder="Enter a color" /> <hello-world/> </body>
修改后的 helloWorld 指令如下:
app.directive('helloWorld', function() { return { restrict: 'AE', replace: true, template: '<p style="background-color:{{color}}">Hello World', link: function(scope, elem, attrs) { elem.bind('click', function() { elem.css('background-color', 'white'); scope.$apply(function() { scope.color = "white"; }); }); elem.bind('mouseover', function() { elem.css('cursor', 'pointer'); }); } }; });
我們注意到指令定義中的 link 函數。 它有三個參數:
scope – 指令的scope。在我們的例子中,指令的scope就是父controller的scope。
elem – 指令的jQLite(jQuery的子集)包裝DOM元素。如果你在引入AngularJS之前引入了jQuery,那么這個元素就是jQuery元素,而不是jQLite元素。由于這個元素已經被jQuery/jQLite包裝了,所以我們就在進行DOM操作的時候就不需要再使用 $()來進行包裝。
attr – 一個包含了指令所在元素的屬性的標準化的參數對象。舉個例子,你給一個HTML元素添加了一些屬性:,那么可以在 link 函數中通過 attrs.someAttribute 來使用它。
link函數主要用來為DOM元素添加事件監聽、監視模型屬性變化、以及更新DOM。在上面的指令代碼片段中,我們添加了兩個事件, click,和 mouseover。click 處理函數用來重置 <p> 的背景色,而 mouseover 處理函數改變鼠標為 pointer。在模板中有一個表達式 {{color}},當父scope中的 color 發生變化時,它用來改變 Hello World 文字的背景色。 這個 plunker 演示了這些概念。
compile函數
compile 函數在 link 函數被執行之前用來做一些DOM改造。它接收下面的參數:
tElement – 指令所在的元素
attrs – 元素上賦予的參數的標準化列表
要注意的是 compile 函數不能訪問 scope,并且必須返回一個 link 函數。但是如果沒有設置 compile 函數,你可以正常地配置 link 函數,(有了compile,就不能用link,link函數由compile返回)。compile函數可以寫成如下的形式:
app.directive('test', function() { return { compile: function(tElem,attrs) { //do optional DOM transformation here return function(scope,elem,attrs) { //linking function here }; } }; });
大多數的情況下,你只需要使用 link 函數。這是因為大部分的指令只需要考慮注冊事件監聽、監視模型、以及更新DOM等,這些都可以在 link 函數中完成。 但是對于像 ng-repeat 之類的指令,需要克隆和重復 DOM 元素多次,在 link 函數執行之前由 compile 函數來完成。這就帶來了一個問題,為什么我們需要兩個分開的函數來完成生成過程,為什么不能只使用一個?要回答好這個問題,我們需要理解指令在Angular中是如何被編譯的!
指令是如何被編譯的
當應用引導啟動的時候,Angular開始使用 $compile 服務遍歷DOM元素。這個服務基于注冊過的指令在標記文本中搜索指令。一旦所有的指令都被識別后,Angular執行他們的 compile 方法。如前面所講的,compile 方法返回一個 link 函數,被添加到稍后執行的 link 函數列表中。這被稱為編譯階段。如果一個指令需要被克隆很多次(比如 ng-repeat),compile函數只在編譯階段被執行一次,復制這些模板,但是link 函數會針對每個被復制的實例被執行。所以分開處理,讓我們在性能上有一定的提高。這也說明了為什么在 compile 函數中不能訪問到scope對象。 在編譯階段之后,就開始了鏈接(linking)階段。在這個階段,所有收集的 link 函數將被一一執行。指令創造出來的模板會在正確的scope下被解析和處理,然后返回具有事件響應的真實的DOM節點。
改變指令的Scope
默認情況下,指令獲取它父節點的controller的scope。但這并不適用于所有情況。如果將父controller的scope暴露給指令,那么他們可以隨意地修改 scope 的屬性。在某些情況下,你的指令希望能夠添加一些僅限內部使用的屬性和方法。如果我們在父的scope中添加,會污染父scope。 其實我們還有兩種選擇:
一個子scope – 這個scope原型繼承子父scope。
一個隔離的scope – 一個孤立存在不繼承自父scope的scope。
這樣的scope可以通過指令定義對象中 scope 屬性來配置。下面的代碼片段是一個例子:
app.directive('helloWorld', function() { return { scope: true, // use a child scope that inherits from parent restrict: 'AE', replace: 'true', template: '<h4>Hello World!!</h4>' }; });
上面的代碼,讓Angular給指令創建一個繼承自父socpe的新的子scope。 另外一個選擇,隔離的scope:
app.directive('helloWorld', function() { return { scope: {}, // use a new isolated scope restrict: 'AE', replace: 'true', template: '<h4>Hello World!!</h4>' }; });
這個指令使用了一個隔離的scope。隔離的scope在我們想要創建可重用的指令的時候是非常有好處的。通過使用隔離的scope,我們能夠保證我們的指令是自包含的,可以被很容易的插入到HTML應用中。 它內部不能訪問父的scope,所保證了父scope不被污染。 在我們的 helloWorld 指令例子中,如果我們將 scope 設置成 {},那么上面的代碼將不會工作。 它會創建一個新的隔離的scope,那么相應的表達式 {{color}} 會指向到這個新的scope中,它的值將是 undefined. 使用隔離的scope并不意味著我們完全不能訪問父scope的屬性。其實有一些技術可以允許我們訪問父scope的屬性,甚至監視他們的變化。我們會在指令這個系列的第二部分中討論這些技術,以及一些更高級的概念,比如 Controller 函數。
關于怎么用AngularJS 指令就分享到這里了,希望以上內容可以對大家有一定的幫助,可以學到更多知識。如果覺得文章不錯,可以把它分享出去讓更多的人看到。
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。