zoukankan      html  css  js  c++  java
  • AngularJS 指令(意义)

    angular.module('modulename')
        .directive('myDirective', function(){
            return {
                restrict: 'EA', //E表示element, A表示attribute,C表示class,M表示commnent,即注释
                scope:{
                    title: '@' //@读属性值,=双向绑定,&用户函数
                }
                template: '<div>{{myVal}}</div>',
                templateUrl: 'app/sample.html',
                controller: 'myController',
                link:function($scope, element, attrs){}//DOM操作
            };
        })
    return{
     //通过设置项来定义
    };

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

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

    1.restrict

    (字符串)可选参数,指明指令在DOM里面以什么形式被声明;

    取值有:E(元素),A(属性),C(类),M(注释),其中默认值为A;

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

    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:"<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="">>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="">>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="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选项本身就会被忽略掉。

  • 相关阅读:
    python uuid
    linux 修改时区
    Nginx 缓存命中率
    MongoDB oplog 详解
    MongoDB 复本集搭建
    复制集简介
    解决Python2.7的UnicodeEncodeError: 'ascii' codec can't encode异常错误
    MongoDB 介绍
    python virtualenv
    Docker Compose 模板文件 V2
  • 原文地址:https://www.cnblogs.com/soyo/p/6730572.html
Copyright © 2011-2022 走看看