angularJs關於指令的一些冷門屬性

　　我們使用ng的時候，經常會使用到指令，大家所熟知的屬性我在這里就不介紹了，講講大家沒怎么留意的屬性

　　1.multiElement

　　　　這是指定指令作用區間的功能，最常用的就是ng-repeat-start和ng-repeat-end了。

　　2.priority

　　　　指令優先級，優先級越高，指令越早執行。

　　3.terminal

　　　　是否允許優先級低的指令起作用，如果是true，那么只有比當前指令或跟當前指令等級相同的指令才可以執行。最典型的就是ngIf

　　4.templateNamespace

　　　　聲明模板的格式有三種選擇 svg、html、math

　　5.transclude 

　　　　或許有人疑問了，transclude也算是冷門屬性嗎？其實大家對transclude了解並沒有想象的那么深，transclude是一個挺復雜的屬性，一般大家會用到的也僅僅是true,false。這兩個屬性我在這里就不講了，在這里我主要講的是transclude:element，我google了一整天都沒找到正確描述這個屬性的方法。我覺得google出來的答案太文檔化了。最后在研究$transclude才看出來這個屬性的功能究竟在哪里。再講功能前我們先了解下$transclude 

　　　　無論在指令的compile還是link時期我們的最后一個參數就是$transclude了，這里其實我們看看源碼是如何定義的，我看的源碼是ng1.5.3的　　　　

function controllersBoundTransclude(scope, cloneAttachFn, futureParentElement, slotName) {
          var transcludeControllers;
          // No scope passed in:
          if (!isScope(scope)) {
            slotName = futureParentElement;
            futureParentElement = cloneAttachFn;
            cloneAttachFn = scope;
            scope = undefined;
          }

          if (hasElementTranscludeDirective) {
            transcludeControllers = elementControllers;
          }
          if (!futureParentElement) {
            futureParentElement = hasElementTranscludeDirective ? $element.parent() : $element;
          }
          if (slotName) {
            // slotTranscludeFn can be one of three things:
            //  * a transclude function - a filled slot
            //  * `null` - an optional slot that was not filled
            //  * `undefined` - a slot that was not declared (i.e. invalid)
            var slotTranscludeFn = boundTranscludeFn.$$slots[slotName];
            if (slotTranscludeFn) {
              return slotTranscludeFn(scope, cloneAttachFn, transcludeControllers, futureParentElement, scopeToChild);
            } else if (isUndefined(slotTranscludeFn)) {
              throw $compileMinErr('noslot',
               'No parent directive that requires a transclusion with slot name "{0}". ' +
               'Element: {1}',
               slotName, startingTag($element));
            }
          } else {
            return boundTranscludeFn(scope, cloneAttachFn, transcludeControllers, futureParentElement, scopeToChild);
          }
        }

還有一個另一個函數要特別指出來，就是最后返回的 boundTranscludeFn 這個方法，下面是他的源碼

function createBoundTranscludeFn(scope, transcludeFn, previousBoundTranscludeFn) {
      function boundTranscludeFn(transcludedScope, cloneFn, controllers, futureParentElement, containingScope) {

        if (!transcludedScope) {
          transcludedScope = scope.$new(false, containingScope);
          transcludedScope.$$transcluded = true;
        }

        return transcludeFn(transcludedScope, cloneFn, {
          parentBoundTranscludeFn: previousBoundTranscludeFn,
          transcludeControllers: controllers,
          futureParentElement: futureParentElement
        });
      }

這兩個方法到底是在做什么呢？其實就是克隆了當前指令的節點，並生成子作用域。克隆的節點由transclude定義，如果你的屬性是true，則克隆的是指令模板中的ng-transclude所在的DOM節點，及其子節點。如果屬性是element則克隆整個模板的節點。

這是兩個指令的代碼

 angular.module('MyApp', [])
            .directive('dropPanel', function() {
                return {
                    transclude: 'element',
                    replace: true,
                    template: "<div class='drop-panel'>" +
                        "<span ng-transclude class='111'></span>" +
                        "</div>",
                    link: function(scope, el, c, d, $transclude) {
                        $transclude(function ngRepeatTransclude(clone, scope) {
                            console.log(clone);
                        })

                    }
                }
            })
            .directive('dropPanel2', function() {
                return {
                    transclude: true,
                    replace: true,
                    template: "<div class='drop-panel'>" +
                        "<span ng-transclude class='111'></span>" +
                        "</div>",
                    link: function(scope, el, c, d, $transclude) {
                        $transclude(function ngRepeatTransclude(clone, scope) {
                            console.log(clone);
                        })
                    }
                }
            })

如果你覺得replace干擾了對結果的理解，你可以注釋掉，然后查看控制台中打印出來的clone，你就能知道所謂transclude的屬性聲明為element的作用了，我們打開replace目的在於能較清楚的查看DOM節點，來獲得結論，下面就是兩者編譯后DOM節點的區別了

　　看完上面的圖，你可以明顯的區別到兩者對DOM的克隆不一樣的，另外如果在聲明屬性為‘element’時，需要聲明replace為true，才能渲染出來。我查了很多資料，最終用斷點得出了我認為對的結論，斷點追蹤的結果是發現如果不聲明replace，好像就不會執行ngTransclude指令，這點我很奇怪，正因為這樣子所以導致沒有成功渲染。二歸根結底其實是兩者的操作的DOM元素不同，在聲明transclude為element時，replace為true，你取到的DOM節點是含有transclude屬性的節點(子節點)，而為false你拿到的並不是含有transclude屬性的節點(父節點)，而ng本身不對其節點進行遍歷，導致沒能執行ngTransclude指令

　　我看到一個觀點覺得不錯，大概意思就是：源於功能的考慮，在使用element屬性的時候，一般都是起占位符的作用，你需要做的操作是對DOM的添加時候，才會用到這個克隆功能。

　　我覺得這個觀點不錯，看過很多關於ngrepeat的介紹，很多文章都說ngrepeat源碼是通過$scope.$new()來生成子作用域的，實際上並不完全正確，他的確是通過$scope.$new產生子作用域的，但是這個產生功能是交給$transclude函數去做得，實際上ngrepeat的源碼上是通過$transclude來生成子作用域和添加DOM節點的。與上面的觀點有相似之處。

　　就講到這里了，這是作者原創，轉載請注明