Question

18.3. 基本的自定义方法

自定义一个指令可以非常非常的复杂，但是其基本的调用形式，同自定义服务大概是相同的：

  <p show style="font-size: 12px;"></p>

  <script type="text/javascript">

  var app = angular.module('Demo', [], angular.noop);

  app.directive('show', function(){
    var func = function($scope, $element, $attrs){
      console.log($scope);
      console.log($element);
      console.log($attrs);
    }    
    return func;
    //return {compile: function(){return func} }
  });

  angular.bootstrap(document, ['Demo']);
  </script>

如果在 directive 中直接返回一个函数，则这个函数会作为 compile 的返回值，也即是作为 link 函数使用。这里说的 compile 和 link 都是一个指令的组成部分，一个完整的定义应该返回一个对象，这个对象包括了多个属性：

• name
• priority
• terminal
• scope
• controller
• require
• restrict
• template
• templateUrl
• replace
• transclude
• compile
• link

上面的每一个属性，都可以单独探讨的。

下面是一个完整的基本的指令定义例子：

  <code lines>
  //失去焦点使用 jQuery 的扩展支持冒泡
  app.directive('ngBlur', function($parse){
    return function($scope, $element, $attr){
      var fn = $parse($attr['ngBlur']);
      $element.on('focusout', function(event){
        fn($scope, {$event: event});
      });
    }
  });
  </code>

  <div code lines>
  //失去焦点使用 jQuery 的扩展支持冒泡
  app.directive('ngBlur', function($parse){
    return function($scope, $element, $attr){
      var fn = $parse($attr['ngBlur']);
      $element.on('focusout', function(event){
        fn($scope, {$event: event});
      });
    }
  });
  </div>

 1   var app = angular.module('Demo', [], angular.noop);
 2   
 3   app.directive('code', function(){
 4     var func = function($scope, $element, $attrs){
 5   
 6       var html = $element.text();
 7       var lines = html.split('\n');
 8   
 9       //处理首尾空白
10       if(lines[0] == ''){lines = lines.slice(1, lines.length - 1)}
11       if(lines[lines.length-1] == ''){lines = lines.slice(0, lines.length - 1)}
12   
13       $element.empty();
14   
15       //处理外框
16       (function(){
17         $element.css('clear', 'both');
18         $element.css('display', 'block');
19         $element.css('line-height', '20px');
20         $element.css('height', '200px');
21       })();
22   
23       //是否显示行号的选项
24       if('lines' in $attrs){
25         //处理行号
26         (function(){
27           var div = $('<div style="width: %spx; background-color: gray; float: left; text-align: right; padding-right: 5px; margin-right: 10px;"></div>'
28                       .replace('%s', String(lines.length).length * 10));
29           var s = '';
30           angular.forEach(lines, function(_, i){
31             s += '<pre style="margin: 0;">%s</pre>\n'.replace('%s', i + 1);
32           });
33           div.html(s);
34           $element.append(div);
35         })();
36       }
37   
38       //处理内容
39       (function(){
40         var div = $('<div style="float: left;"></div>');
41         var s = '';
42         angular.forEach(lines, function(l){
43           s += '<span style="margin: 0;">%s</span><br />\n'.replace('%s', l.replace(/\s/g, '<span>&nbsp;</span>'));
44         });
45         div.html(s);
46         $element.append(div);
47       })();
48     }
49   
50     return {link: func,
51             restrict: 'AE'}; //以元素或属性的形式使用命令
52   });
53   
54   angular.bootstrap(document, ['Demo']);

上面这个自定义的指令，做的事情就是解析节点中的文本内容，然后修改它，再把生成的新内容填充到节点当中去。其间还涉及了节点属性值 lines 的处理。这算是指令中最简单的一种形式。因为它是“一次性使用”，中间没有变量的处理。比如如果节点原来的文本内容是一个变量引用，类似于 { { code } } ，那上面的代码就不行了。这种情况麻烦得多。后面会讨论。