這就是本篇文章的目的，接下來我們會(huì)討論如何創(chuàng)建 AngularJS指令。

創(chuàng)建自定義AngularJS 指令

文章開頭的自定義指令十分的簡(jiǎn)單。它僅僅實(shí)現(xiàn)了同步的功能。一般指令是包含更多元素的：

//創(chuàng)建指令模塊 (或者檢索現(xiàn)有模塊)
var m = angular.module("myApp");
// 創(chuàng)建"my-dir"指令
myApp.directive("myDir", function() {
  return {
    restrict: "E",        // 指令是一個(gè)元素 (并非屬性)
    scope: {              // 設(shè)置指令對(duì)于的scope
      name: "@",          // name 值傳遞 （字符串，單向綁定）
      amount: "=",        // amount 引用傳遞（雙向綁定）
      save: "&"           // 保存操作
    },
    template:             // 替換HTML (使用scope中的變量)
      "
" +
      "  `name`: " +
      "  Save" +
      "
",
    replace: true,        // 使用模板替換原始標(biāo)記
    transclude: false,    // 不復(fù)制原始HTML內(nèi)容
    controller: [ "$scope", function ($scope) { …  }],
    link: function (scope, element, attrs, controller) {…}
  }
});

效果如下：

注意這個(gè)自定義指令遵循一種格式：以"my" 為前綴，類似于命名空間，因此如果你在應(yīng)用中引用了多個(gè)模塊指令，你可以通過前綴很容易的判斷出它是在哪定義的。這不是硬性要求，但是這樣做可以帶來很多便利。

指令的構(gòu)造函數(shù)會(huì)返回帶有屬性的JavaScript 對(duì)象。這些內(nèi)容在AngularJS 主頁中都有清晰說明。以下是我對(duì)一些屬性的理解：

1. restrict: 說明指令在HTML中的應(yīng)用形式，備選項(xiàng)有"A"、"E" 和 "C"， "M" ，分別代表 attribute、element、class和comment（默認(rèn)值為"A"）。我們將更多的關(guān)注attributes-如何創(chuàng)建UI元素。

2. scope: 創(chuàng)建指令的作用范圍，scope在指令中作為屬性標(biāo)簽傳遞。Scope 是創(chuàng)建可以復(fù)用指令的必要條件，每個(gè)指令（不論是處于嵌套指令的哪一級(jí)）都有其唯一的作用域，它不依賴于父scope。scope 對(duì)象定義names 和types 變量。上面的例子即創(chuàng)建了3個(gè)scope變量。

• name: "@" （值傳遞，單向綁定）： "@"符號(hào)表示變量是值傳遞。指令會(huì)檢索從父級(jí)scope中傳遞而來字符串中的值。指令可以使用該值但無法修改，是最常用的變量。

• amount: "=" （引用,雙向綁定）: "="符號(hào)表示變量是引用傳遞。指令檢索主Scope中的引用取值。值可以是任意類型的，包括復(fù)合對(duì)象和數(shù)組。指令可以更改父級(jí)Scope中的值，所以當(dāng)指令需要修改父級(jí)Scope中的值時(shí)我們就需要使用這種類型。

• save: "&" (表達(dá)式) : “&”符號(hào)表示變量是在父級(jí)Scope中啟作用的表達(dá)式。它允許指令實(shí)現(xiàn)比修改值更高級(jí)的操作。

3. template: 替代原始模板中的標(biāo)記的字符串。替換功能將替換所有舊元素為新值。注意template是如何使用Scope中定義的變量的。這允許你無需寫任何額外的代碼即可創(chuàng)建macro-style 風(fēng)格指令。replace: 說明是否替換原始標(biāo)記中的值或是追加原始標(biāo)記中的值。默認(rèn)值是false，這時(shí)原始標(biāo)記將被保留。

4. transclude: 說明自定義指令是否復(fù)制原始標(biāo)記中的內(nèi)容。例如，之前展示的“tab”指令設(shè)置了transclude 為 true，因?yàn)閠ab 元素包含其他HTML 元素。 "dateInput" 指令則需要在初始化時(shí)為空，所以需要設(shè)置transclude 為false。

5. link: 該方法在指令中扮演著重要的角色。它負(fù)責(zé)執(zhí)行DOM 操作和注冊(cè)事件監(jiān)聽器等。link 方法包含以下參數(shù)：

• scope: 指令Scope的引用。scope 變量在初始化時(shí)是不被定義的，link 方法會(huì)注冊(cè)監(jiān)視器監(jiān)視值變化事件。

• element: 包含指令的DOM元素的引用， link 方法一般通過jQuery 操作實(shí)例（如果沒有加載jQuery，還可以使用Angular's jqLite ）。

• controller: 在有嵌套指令的情況下使用。這個(gè)參數(shù)作用在于把子指令的引用提供給父指令，允許指令之間進(jìn)行交互， tab 指令就是使用該參數(shù)較典型的例子：http://jsfiddle.net/powertoolsteam/GBE7N/1/

注意，當(dāng)調(diào)用link 方法時(shí)， 通過值傳遞（"@"）的scope 變量將不會(huì)被初始化，它們將會(huì)在指令的生命周期中另一個(gè)時(shí)間點(diǎn)進(jìn)行初始化，如果你需要監(jiān)聽這個(gè)事件，可以使用scope.$watch 方法。
好了，以上即為自定義指令需要用到基本知識(shí)描述。如果你仍然不熟悉指令，最好的方法就是動(dòng)手實(shí)現(xiàn)幾個(gè)小例子，可以在fiddle中進(jìn)行實(shí)踐：http://jsfiddle.net/powertoolsteam/Tk92U/

在下一篇文章中我們將一起熟悉幾個(gè)AngularJS自定義指令。