angularJS directive详解

Home / Article MrLee 2016-7-27 2926

---

最近学习了下angularjs指令的相关知识，也参考了前人的一些文章，在此总结下。
欢迎批评指出错误的地方。
 
Angularjs指令定义的API
AngularJs的指令定义大致如下

angular.module("app",[]).directive("directiveName",function(){
    return{
     //通过设置项来定义
    };
})

其中return返回的对象包含很多参数，下面一一说明

1.restrict
（字符串）可选参数，指明指令在DOM里面以什么形式被声明；
取值有：E(元素),A(属性),C(类),M(注释)，其中默认值为A；
E(元素)： A(属性)：

C(类)：   

M(注释)：<--directive:directiveName expression-->

例如restrict：‘EA’ 则表示指令在DOM里面可用元素形式和属性形式被声明；
一般来说，当你创建一个有自己模板的组件的时候，需要使用元素名，如果仅仅是为为已有元素添加功能的话，就使用属性名
注意：如果想支持IE8，则最好使用属性和类形式来定义。 另外Angular从1.3.x开始, 已经放弃支持IE8了.
2.priority
(数字)，可选参数，指明指令的优先级，若在单个DOM上有多个指令，则优先级高的先执行；
设置指令的优先级算是不常用的
比较特殊的的例子是，angularjs内置指令的ng-repeat的优先级为1000，ng-init的优先级为450；
3.terminal
（布尔型），可选参数，可以被设置为true或false，若设置为true，则优先级低于此指令的其他指令则无效，不会被调用(优先级相同的还是会执行)
4.template（字符串或者函数）可选参数，可以是：
（1）一段HTML文本

angular.module("app",[]).directive("hello",function(){
                return{
                 restrict:'EA',
                 template:"
hello world
"
                };
            })

HTML代码为：

结果渲染后的HTML为：
   
hello world

（2）一个函数，可接受两个参数tElement和tAttrs
其中tElement是指使用此指令的元素，而tAttrs则实例的属性，它是一个由元素上所有的属性组成的集合（对象）形如：

{
title：‘aaaa’,
name:'leifeng'
}

下面让我们看看template是一个函数时候的情况

angular.module("app",[]).directive("directitle",function(){
                return{
                 restrict:'EAC',
                 template: function(tElement,tAttrs){
                    var _html = '';
                    _html += '
'+tAttrs.title+'
';
                    return _html;
                 }
                };
            })

HTML代码：

渲染之后的HTML：
biaoti

因为一段HTML文本，阅读跟维护起来都是很麻烦的，所用通常会使用templateUrl这个。
5.templateUrl（字符串或者函数），可选参数，可以是
（1）一个代表HTML文件路径的字符串
（2）一个函数，可接受两个参数tElement和tAttrs（大致同上）
注意：在本地开发时候，需要运行一个服务器，不然使用templateUrl会报错 Cross Origin Request Script（CORS）错误
由于加载html模板是通过异步加载的，若加载大量的模板会拖慢网站的速度，这里有个技巧，就是先缓存模板
你可以再你的index页面加载好的，将下列代码作为你页面的一部分包含在里面。

           
我是模板内容

这里的id属性就是被设置在templateUrl上用的。
另一种办法缓存是:

angular.module("template.html", []).run(["$templateCache", function($templateCache) {
  $templateCache.put("template.html",
    "
wo shi mu ban
");
}]);

 
6.replace
（布尔值），默认值为false，设置为true时候，我们再来看看下面的例子（对比下在template时候举的例子）

angular.module("app",[]).directive("hello",function(){
                return{
                 restrict:'EA',
                 replace：true,
                 template:"
hello world
"
                };
            })

HTML代码为：

渲染之后的代码：
hello world

对比下没有开启replace时候的渲染出来的HTML。发现不见了。
另外当模板为纯文本（即template:"wo shi wen ben"）的时候，渲染之后的html代码默认的为文本用span包含。
7.scope
可选参数，（布尔值或者对象）默认值为false，可能取值：
（1）默认值false。
表示继承父作用域;
（2）true
表示继承父作用域，并创建自己的作用域（子作用域）;
（3）{}
表示创建一个全新的隔离作用域；
7.1首先我们先来了解下scope的继承机制。我们用ng-controller这个指令举例，
我们都知道ng-controller（内置指令）可以从父作用域中继承并且创建一个新的子作用域。如下：

  


  
    parentNode：{{aaa}}
    
        chrildNode： {{aaa}}
    

  

   这时页面显示是
parentNode：父亲
chrildNode： 儿子
若去掉

 $scope.aaa = '儿子'

则显示
parentNode：父亲
chrildNode： 父亲
注意：
1）若一个元素上有多个指令，使用了隔离作用域，则只有其中一个可以生效；
2）只有指令模板中的根元素才能获得一个新的作用域，这时候，scope就被设置为true了；

  


  
    parentNode：{{aaa}}
    
        chrildNode： {{aaa}}
        
          {{aaa}}
        

    

  

   页面显示为：
parentNode：父亲
chrildNode： cunjieliu
孙女
上面中class为one那个div获得了指令ng-controller=’myController‘所创建的新的作用域；
而class为two那个div获得了指令ng-controller=’myController2‘所创建的新的作用域；
这就是“只有指令模板中的根元素才能获得一个新的作用域”；
 
接下来我们通过一个简单明了的例子来说明scope取值不同的差别

  


  
        父亲: {{name}}
        
        

  


  
           
           //注意这里设置了color-attr属性，绑定了{{color}}
  
  

html：
  
js定义指令的片段：
app.directive('helloWorld',function(){
    return {
        scope: {
            color: '@'
        },
        ...
        //配置的余下部分
    }
});

  


  
        
        {{color}}
          //注意这里的写法
  
  

  


  
        
        {{name}}
         //注意这里
  
  

  


  
        
          
china
          
            {{name}}
          
        
  
  

   {{name}}

angular.module('myApp', []) 
.directive('myDirective', function() { 
restrict: 'A', // 始终需要
controller: 'SomeController' 
}) 
// 应用中其他的地方，可以是同一个文件或被index.html包含的另一个文件
angular.module('myApp') 
.controller('SomeController', function($scope, $element, $attrs, $transclude) { 
// 控制器逻辑放在这里
});

angular.module('myApp',[]) 
.directive('myDirective', function() { 
restrict: 'A', 
controller: 
function($scope, $element, $attrs, $transclude) { 
// 控制器逻辑放在这里
} 
});

html代码:   雷锋叔叔的博客
           
js代码：
  

        
          
雷锋叔叔的博客
        
   
  

angular.module("app",[])
  .controller("demoController",["$scope",function($scope){
    $scope.title = "angualr";
  }])
 
      {{title}}

angular.module("app",[])
  .controller("demoController",[function(){
    this.title = "angualr";
  }])
  
       {{demo.title}}
  

//compile函数的语法
compile:function compile(tElement,tAttrs,transclude){
      return{
        pre:function preLink(scope,iElement,iAttrs,controller){},
        post:function postLink(scope,iElement,iAttrs,controller){}
      }
    }

//link链接函数
link:function postLink(scope,iElement,iAttrs){}

本文链接:https://www.it72.com/9811.htm