18.5. Compile的细节


    指令的处理过程,是 ng 的 Compile 过程的一部分,它们也是紧密联系的。继续深入指令的定义方法,首先就要对 Compile 的过程做更细致的了解。



    前面说过, ng 对页面的处理过程:


    • 浏览器把 HTML 字符串解析成 DOM 结构。

    • ng 把 DOM 结构给 $compile ,返回一个 link 函数。

    • 传入具体的 scope 调用这个 link 函数。

    • 得到处理后的 DOM ,这个 DOM 处理了指令,连接了数据。


    $compile 最基本的使用方式:

    1. var link = $compile('<p>{{ text }}</p>');
      var node = link($scope);
      console.log(node);


    上面的 $compilelink 调用时都有额外参数来实现其它功能。先看 link 函数,它形如:

    1. function(scope[, cloneAttachFn]


    第二个参数 cloneAttachFn 的作用是,表明是否复制原始节点,及对复制节点需要做的处理,下面这个例子说明了它的作用:

    1. <div ng-controller="TestCtrl"></div>
      <div id="a">A {{ text }}</div>
      <div id="b">B </div>
    1. app.controller('TestCtrl', function($scope, $compile){
      var link = $compile($('#a'));

      //true参数表示新建一个完全隔离的scope,而不是继承的child scope
      var scope = $scope.$new(true);
      scope.text = '12345';

      //var node = link(scope, function(){});
      var node = link(scope);

      $('#b').append(node);
      });


    cloneAttachFn 对节点的处理是有限制的,你可以添加 class ,但是不能做与数据绑定有关的其它修改(修改了也无效):

    1. app.controller('TestCtrl', function($scope, $compile){
      var link = $compile($('#a'));
      var scope = $scope.$new(true);
      scope.text = '12345';

      var node = link(scope, function(clone_element, scope){
      clone_element.text(clone_element.text() + ' …'); //无效
      clone_element.text('{{ text2 }}'); //无效
      clone_element.addClass('new_class');
      });

      $('#b').append(node);
      });


    修改无效的原因是,像 {{ text }} 这种所谓的 Interpolate$compile 中已经被处理过了,生成了相关函数(这里起作用的是 directive 中的一个 postLink 函数),后面执行 link 就是执行了 $compile 生成的这些函数。当然,如果你的文本没有数据变量的引用,那修改是会有效果的。



    前面在说自定义指令时说过, link 函数是由 compile 函数返回的,也就像前面说的,应该把改变 DOM 结构的逻辑放在 compile 函数中做。



    $compile 还有两个额外的参数:

    1. $compile(element, transclude, maxPriority);


    maxPriority 是指令的权重限制,这个容易理解,后面再说。



    transclude 是一个函数,这个函数会传递给 compile 期间找到的 directivecompile 函数(编译节点的过程中找到了指令,指令的 compile 函数会接受编译时传递的 transclude 函数作为其参数)。



    但是在实际使用中,除我们手工在调用 $compile 之外,初始化时的根节点 compile 是不会传递这个参数的。



    在我们定义指令时,它的 compile 函数是这个样子的:

    1. function compile(tElement, tAttrs, transclude) { }


    事实上, transclude 的值,就是 directive 所在的 原始 节点,把原始节点重新做了编译之后得到的 link 函数(需要 directive 定义时使用 transclude 选项),后面会专门演示这个过程。所以,官方文档上也把 transclude 函数描述成 link 函数的样子(如果自定义的指令只用在自己手动 $compile 的环境中,那这个函数的形式是可以随意的):

    1. {function(angular.Scope[, cloneAttachFn]}


    所以记住,定义指令时, compile 函数的第三个参数 transclude ,就是一个 link ,装入 scope 执行它你就得到了一个节点。