angularJs指令深度分析

时间  2019-11-30
标签 angularjs 指令 深度 分析 栏目 AngularJS 繁體版
原文   原文链接

AngularJs的指令定义大体以下

angular.module("app",[]).directive("directiveName",function(){javascript

return{ //经过设置项来定义 };

})其中return返回的对象包含不少参数，下面一一说明css

你知道用AngularJs怎么定义指令吗？html

1.restrictjava

（字符串）可选参数，指明指令在DOM里面以什么形式被声明；angularjs

取值有：E(元素),A(属性),C(类),M(注释)，其中默认值为A；express

E(元素)：<directiveName></directiveName>
A(属性)：<div directiveName='expression'></div>
C(类)： <div class='directiveName'></div>
M(注释)：<--directive:directiveName expression-->数组

2.priority缓存

(数字)，可选参数，指明指令的优先级，若在单个DOM上有多个指令，则优先级高的先执行；服务器

设置指令的优先级算是不经常使用的app

比较特殊的的例子是，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:"<div><h3>hello world</h3></div>" }; })

HTML代码为：<hello></hello>
结果渲染后的HTML为：<hello>
<div><h3>hello world</h3></div>
</hello>
（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 += '<div>'+tAttrs.title+'</div>'; return _html; } }; })

HTML代码：<directitle title='biaoti'></directitle>
渲染以后的HTML：<div>biaoti</div>
由于一段HTML文本，阅读跟维护起来都是很麻烦的，所用一般会使用templateUrl这个。

5.templateUrl（字符串或者函数），可选参数，能够是

（1）一个表明HTML文件路径的字符串

（2）一个函数，可接受两个参数tElement和tAttrs（大体同上）

注意：在本地开发时候，须要运行一个服务器，否则使用templateUrl会报错 Cross Origin Request Script（CORS）错误

因为加载html模板是经过异步加载的，若加载大量的模板会拖慢网站的速度，这里有个技巧，就是先缓存模板

你能够再你的index页面加载好的，将下列代码做为你页面的一部分包含在里面。

<script type='text/ng-template' id='woshimuban.html'>

<div>我是模板内容</div>

</script>这里的id属性就是被设置在templateUrl上用的。

另外一种办法缓存是:

angular.module("template.html", []).run(["$templateCache", function($templateCache) {$templateCache.put("template.html",

"<div>wo shi mu ban</div>");

}]);

 

6.scope

可选参数，（布尔值或者对象）默认值为false，可能取值：

（1）默认值false。

表示继承父做用域;

（2）true

表示继承父做用域，并建立本身的做用域（子做用域）;

（3）{}

表示建立一个全新的隔离做用域；

接下来咱们经过一个简单明了的例子来讲明scope取值不一样的差异

<!doctype html>
<html ng-app="myApp">
<head>
<script src="http://cdn.staticfile.org/ang...
</head>
<body>

<div ng-controller='MainController'>

父亲: {{name}} <input ng-model="name" /> <div my-directive></div>

</div>

<script>

 1 angular.module('myApp', [])
 2 .controller('MainController', function ($scope) {
 3 $scope.name = 'leifeng';
 4 })
 5 .directive('myDirective', function () {
 6 return {
 7 restrict: 'EA',
 8 scope:false,//改变此处的取值,看看有什么不一样
 9 template: '<div>儿子:{{ name }}<input ng-model="name"/></div>'
10 };
11 });

 

依次设置scope的值false，true，{}，结果发现（你们别偷懒，动手试试哈）

. 当为false时候，儿子继承父亲的值，改变父亲的值，儿子的值也随之变化，反之亦如此。（继承不隔离）

. 当为true时候，儿子继承父亲的值，改变父亲的值，儿子的值随之变化，可是改变儿子的值，父亲的值不变。（继承隔离）

. 当为{}时候，没有继承父亲的值，因此儿子的值为空，改变任何一方的值均不能影响另外一方的值。（不继承隔离）

tip：当你想要建立一个可重用的组件时隔离做用域是一个很好的选择，经过隔离做用域咱们确保指令是‘独立’的,并能够轻松地插入到任何HTML app中，而且这种作法防止了父做用域被污染；

6.2隔离做用域能够经过绑定策略来访问父做用域的属性。

 1 <!doctype html>
 2 <html ng-app="myApp">
 3 <head>
 4 <script src="http://cdn.staticfile.org/ang...
 5 </head>
 6 <body>
 7 
 8 <div ng-controller='MainController'>
 9 
10     <input type="text" ng-model="color" placeholder="Enter a color"/>   //这里输入的color不会被检测到指令中
11     <hello-world></hello-world>
12 </div>
13 
14 <script>
15 
16 var app = angular.module('myApp',[]);
17 app.controller('MainController',function(){});
18 app.directive('helloWorld',function(){
19  return {
20  scope: {}, 21     restrict: 'AE',
22     replace: true,
23     template: '<p style="background-color:{{color}}">Hello World</p>'      
24  }
25 });
26 </script>
27 
28 </body>
29 </html>

在输入框改变color的值不会反映到指令中去。

缘由在于，这里咱们将scope设置为{}，产生了隔离做用域。

因此在template模板中{{color}}变成了依赖于本身的做用域，而不是依赖于父做用域。

所以咱们须要一些办法来让隔离做用域能读取父做用域的属性，就是绑定策略。

下面咱们就来探索设置这种绑定的几种方法

方法一：使用@（@attr）来进行单向文本（字符串）绑定

 1 <!doctype html>
 2 <html ng-app="myApp">
 3 <head>
 4 <script src="http://cdn.staticfile.org/ang...
 5 </head>
 6 <body>
 7 
 8 <div ng-controller='MainController'>
 9 
10     <input type="text" ng-model="color" placeholder="Enter a color"/>   
11     <hello-world color-attr='{{color}}'></hello-world>   //注意这里设置了color-attr属性，绑定了{{color}} 12 </div>
13 
14 <script>
15 
16 var app = angular.module('myApp',[]);
17 app.controller('MainController',function(){});
18 app.directive('helloWorld',function(){
19  return {
20  scope: {color:'@colorAttr'},  //指明了隔离做用域中的属性color应该绑定到属性colorAttr
21     restrict: 'AE',
22     replace: true,
23     template: '<p style="background-color:{{color}}">Hello World</p>'      
24  }
25 });
26 </script>
27 
28 </body>
29 </html>

这种办法只能单向，经过在运行的指令的那个html标签上设置color-attr属性，而且采用{{}}绑定某个模型值。

注意，你也能够再这里直接绑定字符串的颜色值,如：color-attr=“red”；但颜色就是固定值了。

当表达式的值发生变化时，属性color-attr也会发生变化，因此也改变了隔离做用域中的属性color。

tips：若是绑定的隔离做用域属性名与元素的属性名相同，则能够采起缺省写法。

 1 html：<hello-world color="{{color}}"/>
 2 
 3 js定义指令的片断：app.directive('helloWorld',function(){
 4 
 5 return {
 6     scope: {
 7         color: '@'
 8     },
 9     ...
10     //配置的余下部分
11 }
12 });

方法二：使用=（=attr）进行双向绑定

 1 <div ng-controller='MainController'>
 2 
 3     <input type="text" ng-model="color" placeholder="Enter a color"/>
 4     {{color}}
 5     <hello-world color='color'></hello-world>  //注意这里的写法
 6 </div>
 7 
 8 <script>
 9 
10 var app = angular.module('myApp',[]);
11 app.controller('MainController',function(){});
12 app.directive('helloWorld',function(){
13  return {
14     scope:{color:'='},
15     restrict: 'AE',
16     replace: true,
17     template: '<div style="background-color:{{color}}">Hello World<div><input type="text" ng-model="color"></div></div>'      
18  }
19 });
20 </script>

这样一个双向绑定被创建了，改变任何一个input都会改变另外一个值。

方法三：使用&来调用父做用域中的函数

 1 <div ng-controller='MainController'>
 2 
 3     <input type="text" ng-model="name" placeholder="Enter a color"/>
 4     {{name}}
 5     <hello-world saysomething999="say();" name="liucunjie"></hello-world> //注意这里
 6 </div>
 7 
 8 <script>
 9 
10 var app = angular.module('myApp',[]);
11 app.controller('MainController',function($scope){
12   $scope.say = function(){
13     alert('hello');
14   }
15   $scope.name = 'leifeng';
16 });
17 app.directive('helloWorld',function(){
18  return {
19     scope:{
20       saysomething:'&saysomething999',
21       name:'@'
22     },
23     restrict: 'AE',
24     replace: true, //这里设置为true表示什么(单项绑定：....) 25     template: '<button type="button" ng-bind="name" ng-init="saysomething();"></button>'
26  }
27 });
28 </script>

运行以后，弹出alert框。

7.transclude

（布尔值或者字符‘element’），默认值为false；

这个配置选项可让咱们提取包含在指令那个元素里面的内容，再将它放置在指令模板的特定位置。

当你开启transclude后，你就可使用ng-transclude来指明了应该在什么地方放置transcluded内容.

 1 <div ng-controller='MainController'>
 2 
 3     <div class='a'>
 4       <p>china</p>
 5       <hello-world>
 6         {{name}}
 7       </hello-world>
 8     </div>
 9 </div>
10 
11 <script>
12 
13 var app = angular.module('myApp',[]);
14 app.controller('MainController',function($scope){
15   $scope.name = 'leifeng';
16 });
17 app.directive('helloWorld',function(){
18  return {
19     scope:{},  
20     restrict: 'AE',
21     transclude: true,
22     template: '<div class="b"><div ng-transclude>你看不见我</div></div>'
23  }
24 });
25 </script>

另外当开启transclude，会建立一个新的transclude空间，而且继承了父做用域（即便Scope设置为隔离做用域），

上面代码中的{{name}}是依赖于父做用域的，仍然能被渲染出来，就说明了这点。

咱们再看看生成的html为下图所示，能够发现文本“你看不见我”消失了，这是由于被transclude内容替换掉了。

8.controller

 

能够是一个字符串或者函数。

 

如果为字符串，则将字符串当作是控制器的名字，来查找注册在应用中的控制器的构造函数

 1 angular.module('myApp', []) 
 2 .directive('myDirective', function() { 
 3 restrict: 'A', // 始终须要
 4 controller: 'SomeController' 
 5 }) 
 6 // 应用中其余的地方，能够是同一个文件或被index.html包含的另外一个文件
 7 angular.module('myApp') 
 8 .controller('SomeController', function($scope, $element, $attrs, $transclude) { 
 9 // 控制器逻辑放在这里
10 });
11 

    也能够直接在指令内部的定义为匿名函数，一样咱们能够再这里注入任何服务（$log,$timeout等等）
12 
13 angular.module('myApp',[]) 
14 .directive('myDirective', function() { 
15 restrict: 'A', 
16 controller: 
17 function($scope, $element, $attrs, $transclude) { 
18 // 控制器逻辑放在这里
19 } 
20 });

另外还有一些特殊的服务（参数）能够注入

（1）$scope，与指令元素相关联的做用域

（2）$element，当前指令对应的 元素

（3）$attrs，由当前元素的属性组成的对象

（4）$transclude，嵌入连接函数，实际被执行用来克隆元素和操做DOM的函数

注意： 除非是用来定义一些可复用的行为，通常不推荐在这使用。

<my-site site="http://www.cnblogs.com/yoissee"><div>coder——231的博客</div></my-site>
 1 angular.module('myApp',[]).directive('mySite', function () {
 2  return {
 3      restrict: 'EA',
 4      transclude: true, //注意此处必须设置为true
 5      controller:
 6      function ($scope, $element,$attrs,$transclude,$log) {  //在这里你能够注入你想注入的服务
 7          $transclude(function (clone) {              
 8              var a = angular.element('<a>');
 9              a.attr('href', $attrs.site);
10              a.text(clone.text()); //这里的clone.text()就是 coder_231的博客 11              $element.append(a);
12          });
13          $log.info("hello everyone");
14      }
15  };

注意：使用$transclude会生成一个新的做用域。

默认状况下，若是咱们简单实用$transclude()，那么默认的其做用域就是$transclude生成的做用域

可是若是咱们实用$transclude($scope,function(clone){}),那么做用域就是directive的做用域了

那么问题又来了。若是咱们想实用父做用域呢

可使用$scope.$parent

 

 1 <div ng-controller='parentctrl'>
 2 
 3     <div ng-controller='sonctrl'>
 4       <my-site site="http://www.cnblogs.com/cunjieliu"><div>coder的博客</div></my-site>
 5     </div>
 6 </div> <script>
 7 
 8 var app = angular.module('myApp',[]);
 9 app.controller('sonctrl',function($scope){
10   $scope.title = 'hello son';
11 });
12 app.controller('parentctrl',function($scope){
13   $scope.title = 'hello parent';
14 });
15 app.directive('mySite', function () {
16  return {
17      restrict: 'EA',
18      transclude: true,
19      controller:
20      function ($scope, $element,$attrs,$transclude,$log) {
21         var a = $transclude();
22         $element.append(a);
23  $log.info($scope.title); //‘hello son' 24  $log.info($scope.$parent.title); //hello parent 25      } 
26  };
27 });
28 </script>

 

9.controllerAs

 

这个选项的做用是能够设置你的控制器的别名

 

通常之前咱们常常用这样方式来写代码：

1 angular.module("app",[]) .controller("demoController",["$scope",function($scope){
2 
3 $scope.title = "angualr";
4 }])
5 
6 <div ng-app="app" ng-controller="demoController">
7 
8 {{title}}
9 </div>

后来angularjs1.2给咱们带来新语法糖，因此咱们能够这样写

1 angular.module("app",[]) .controller("demoController",[function(){
2 
3 this.title = "angualr";
4 }])
5 
6 <div ng-app="app" ng-controller="demoController as demo">
7 
8 {{demo.title}}
9 </div>

10.require(字符串或者数组)

 

字符串表明另外一个指令的名字，它将会做为link函数的第四个参数

 

具体用法咱们能够举个例子说明

假设如今咱们要编写两个指令，两个指令中的link连接函数中（link函数后面会讲）存在有不少重合的方法，

这时候咱们就能够将这些重复的方法写在第三个指令的controller中（上面也讲到controller常常用来提供指令间的复用行为）

而后在这两个指令中，require这个拥有controller字段的的指令（第三个指令），

最后经过link连接函数的第四个参数就能够引用这些重合的方法了。

 1 <outer-directive>
 2 
 3  <inner-directive></inner-directive>
 4  <inner-directive2></inner-directive2>
 5 </outer-directive> 
 6 <script>
 7 var app = angular.module('myApp', []);
 8 app.directive('outerDirective', function() {
 9       return {
10            scope: {},
11            restrict: 'AE',
12            controller: function($scope) {      
13               this.say = function(someDirective) { 
14                  console.log('Got:' + someDirective.message);
15               };
16            }
17        };
18 });
19 app.directive('innerDirective', function() {
20       return {
21            scope: {},
22            restrict: 'AE',
23            require: '^outerDirective', 24            link: function(scope, elem, attrs, controllerInstance) {
25                    scope.message = "Hi,leifeng";
26                    controllerInstance.say(scope); //打印hi.leifeng
27            }
28       };
29 });
30 app.directive('innerDirective2', function() {
31       return {
32            scope: {},
33            restrict: 'AE',
34            require: '^outerDirective', 35            link: function(scope, elem, attrs, controllerInstance) { //第4个参数指向的就是那个controller 36                    scope.message = "Hi,shushu";
37                    controllerInstance.say(scope);
38            }
39       };
40 });
41 
42 </script>

上面例子中的指令innerDirective和指令innerDirective2复用了定义在指令outerDirective的controller中的方法

也进一步说明了，指令中的controller是用来让不一样指令间通讯用的。

另外咱们能够在require的参数值加上下面的某个前缀，这会改变查找控制器的行为：

（1）没有前缀，指令会在自身提供的控制器中进行查找，若是找不到任何控制器，则会抛出一个error

（2）？若是在当前的指令没有找到所需的控制器，则会将null传给link链接函数的第四个参数

（3）^若是在当前的指令没有找到所需的控制器，则会查找父元素的控制器

（4）?^组合

11.Anguar的指令编译过程

首先加载angularjs库，查找到ng-app指令，从而找到应用的边界，根据ng-app划定的做用域来调用$compile服务进行编译，angularjs会遍历整个HTML文档，并根据js中指令

的定义来处理在页面上声明的各个指令按照指令的优先级(priority)排列，根据指令中的配置参数(template，place，transclude等)转换DOM，而后就开始按顺序执行各指令的

compile函数（若是指令上有定义compile函数）对模板自身进行转换。

注意：此处的compile函数是咱们指令中配置的，跟上面说的$compile服务不同。

每一个compile函数执行完后都会返回一个link函数，全部的link函数会合成一个大的link函数而后这个大的link函数就会被执行，主要作数据绑定，经过在DOM上注册监听器来动态

修改scope中的数据，或者是使用$watchs监听 scope中的变量来修改DOM，从而创建双向绑定等等。若咱们的指令中没有配置compile函数，那咱们配置的link函数就会运行，

她作的事情大体跟上面complie返回以后全部的link函数合成的的大的link函数差很少。

因此：在指令中compile与link选项是互斥的，若是同时设置了这两个选项，那么就会把compile所返回的函数当作是连接函数，而link选项自己就会被忽略掉。

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程