首頁 > web前端 > js教程 > 主體

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

高洛峰
發布: 2016-12-09 11:21:45
原創
998 人瀏覽過

我們使用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=&#39;drop-panel&#39;>" +
            "<span ng-transclude class=&#39;111&#39;></span>" +
            "</div>",
          link: function(scope, el, c, d, $transclude) {
            $transclude(function ngRepeatTransclude(clone, scope) {
              console.log(clone);
            })
 
          }
        }
      })
      .directive(&#39;dropPanel2&#39;, function() {
        return {
          transclude: true,
          replace: true,
          template: "<div class=&#39;drop-panel&#39;>" +
            "<span ng-transclude class=&#39;111&#39;></span>" +
            "</div>",
          link: function(scope, el, c, d, $transclude) {
            $transclude(function ngRepeatTransclude(clone, scope) {
              console.log(clone);
            })
          }
        }
      })
登入後複製

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

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

看完上面的圖,你可以明顯的區別到兩者對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節點的。與上面的觀點有相似之處。


相關標籤:
來源:php.cn
本網站聲明
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn
熱門教學
更多>
最新下載
更多>
網站特效
網站源碼
網站素材
前端模板
關於我們 免責聲明 Sitemap
PHP中文網:公益線上PHP培訓,幫助PHP學習者快速成長!