文档章节

angularJS directive分析

专业花农-业余码农
 专业花农-业余码农
发布于 2016/12/09 15:35
字数 3045
阅读 9
收藏 1
点赞 0
评论 0

发现对directive指令研究不深,在这里学习下;

用法大致如下

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

return对象包含:

restrict

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

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

priority

(数字),可选参数,指明指令的优先级,若在单个DOM上有多个指令,则优先级高的先 设置指令的优先级算是不常用 比较特殊的的例子是,angularjs内置指令的ng-repeat的优先级为1000,ng-init的优先级为450;

terminal

(布尔型),可选参数,可以被设置为true或false,若设置为true,则优先级低于此指令的其他指令则无效,不会被调用(优先级相同的还是会执行)

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>
  1. 一个函数,可接受两个参数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这个。

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>");
}]);

replace

(布尔值),默认值为false,设置为true时候,不显示指令标签名。

scope

  • 可选参数,(布尔值或者对象)默认值为false,可能取值:
    • 默认值false。表示继承父作用域;
    • true,表示继承父作用域,并创建自己的作用域(子作用域);
    • {},表示创建一个全新的隔离作用域;
  1. $scope的继承机制。用ng-controller这个指令举例, ng-controller(内置指令)可以从父作用域中继承并且创建一个新的子作用域。如下:
<!doctype html>
<html ng-app="myApp">
<head>
  <script src="http://cdn.staticfile.org/angular.js/1.2.10/angular.min.js"></script>
</head>
<body>
  <div ng-init="aaa='父亲'">
    parentNode:{{aaa}}
    <div ng-controller="myController">
        chrildNode: {{aaa}}
    </div>
  </div>

  <script>
    angular.module('myApp', [])
    .controller('myController',function($scope){
       $scope.aaa = '儿子'
    })
  </script>
</body>
</html>

这时页面显示是

  • parentNode:父亲
  • chrildNode: 儿子

若去掉 $scope.aaa = '儿子' 则显示

  • parentNode:父亲
  • chrildNode: 父亲

注意: 1. 若一个元素上有多个指令,使用了隔离作用域,则只有其中一个可以生效; 2. 只有指令模板中的根元素才能获得一个新的作用域,这时候,scope就被设置为true了;

<!doctype html>
<html ng-app="myApp">
<head>
  <script src="http://cdn.staticfile.org/angular.js/1.2.10/angular.min.js"></script>
</head>
<body>
  <div ng-init="aaa='父亲'">
    parentNode:{{aaa}}
    <div class='one' ng-controller="myController">
        chrildNode: {{aaa}}
        <div class='two' ng-controller='myController2'>
          {{aaa}}
        </div>
    </div>
  </div>

  <script>
    angular.module('myApp', [])
    .controller('myController',function($scope){
      $scope.aaa = '儿子';
    })
    .controller('myController2',function($scope){
      $scope.aaa = '孙女';
    })
  </script>
</body>
</html>

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

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

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

  <script>
    angular.module('myApp', [])
        .controller('MainController', function ($scope) {
           $scope.name = 'father';
        })
        .directive('myDirective', function () {
            return {
                restrict: 'EA',
                scope:false,//改变此处的取值,看看有什么不同
                template: '<div>儿子:{{ name }}<input ng-model="name"/></div>'
            };
        });
  </script>
</body>
</html>

依次设置scope的值false,true,{},结果发现

当为false时候,儿子继承父亲的值,改变父亲的值,儿子的值也随之变化,反之亦如此。(继承不隔离)

当为true时候,儿子继承父亲的值,改变父亲的值,儿子的值随之变化,但是改变儿子的值,父亲的值不变。(继承隔离)

当为{}时候,没有继承父亲的值,所以儿子的值为空,改变任何一方的值均不能影响另一方的值。(不继承隔离)

tip:当你想要创建一个可重用的组件时隔离作用域是一个很好的选择,通过隔离作用域我们确保指令是‘独立’的,并可以轻松地插入到任何HTML app中,并且这种做法防止了父作用域被污染; 2. 隔离作用域可以通过绑定策略来访问父作用域的属性。

  • 下面看一个例子
<!doctype html>
<html ng-app="myApp">
<head>
  <script src="http://cdn.staticfile.org/angular.js/1.2.10/angular.min.js"></script>
</head>
<body>
  <div ng-controller='MainController'>
        <input type="text" ng-model="color" placeholder="Enter a color"/>   
        <hello-world></hello-world>
  </div>
  <script>
    var app = angular.module('myApp',[]);
    app.controller('MainController',function(){});
    app.directive('helloWorld',function(){
     return {
        scope: false,
        restrict: 'AE',
        replace: true,
        template: '<p style="background-color:{{color}}">Hello World</p>'      
     }
    });
  </script>
</body>
</html>
- 运行代码,并在input中输入颜色值
- 但是,但我们将scope设置为{}时候,再次运行上面的代码可以发现页面并不能成功完整显示!
- 原因在于,这里我们将scope设置为{},产生了隔离作用域。
- 所以在template模板中{{color}}变成了依赖于自己的作用域,而不是依赖于父作用域。
- 因此我们需要一些办法来让隔离作用域能读取父作用域的属性,就是绑定策略。
- 下面我们就来探索设置这种绑定的几种方法

方法:使用@(@attr)来进行单向文本(字符串)绑定

<!doctype html>
<html ng-app="myApp">
<head>
  <script src="http://cdn.staticfile.org/angular.js/1.2.10/angular.min.js"></script>
</head>
<body>
  <div ng-controller='MainController'>
        <input type="text" ng-model="color" placeholder="Enter a color"/>   
        <hello-world color-attr='{{color}}'></hello-world>   //注意这里设置了color-attr属性,绑定了{{color}}
  </div>
  <script>
    var app = angular.module('myApp',[]);
    app.controller('MainController',function(){});
    app.directive('helloWorld',function(){
     return {
        scope: {color:'@colorAttr'},  //指明了隔离作用域中的属性color应该绑定到属性colorAttr
        restrict: 'AE',
        replace: true,
        template: '<p style="background-color:{{color}}">Hello World</p>'      
     }
    });
  </script>
</body>
</html>

这种办法只能单向,通过在运行的指令的那个html标签上设置color-attr属性,并且采用{{}}绑定某个模型值。 注意,你也可以再这里直接绑定字符串的颜色值,如:color-attr=“red”; 然后你可以看到表达式{{color}}被赋值给了color-attr。 当表达式的值发生变化时,属性color-attr也会发生变化,所以也改变了隔离作用域中的属性color。 其他方法不再描述,有兴趣的查看原帖。

transclude

(布尔值或者字符‘element’),默认值为false;

  • 这个配置选项可以让我们提取包含在指令那个元素里面的内容,再将它放置在指令模板的特定位置。
  • 当你开启transclude后,你就可以使用ng-transclude来指明应该在什么地方放置transcluded内容
<!doctype html>
<html ng-app="myApp">
<head>
  <script src="http://cdn.staticfile.org/angular.js/1.2.10/angular.min.js"></script>
</head>
<body>
  <div ng-controller='MainController'>
        <div class='a'>
          <p>china</p>
          <hello-world>
            {{name}}
          </hello-world>
        </div>
  </div>
  <script>
    var app = angular.module('myApp',[]);
    app.controller('MainController',function($scope){
      $scope.name = 'leifeng';
    });
    app.directive('helloWorld',function(){
     return {
        scope:{},  
        restrict: 'AE',
        transclude: true,
        template: '<div class="b"><div ng-transclude>你看不见我</div></div>'
     }
    });
  </script>
</body>
</html>

运行上面的代码,输出 china leifeng

  • 另外当开启transclude,会创建一个新的transclude空间,并且继承了父作用域(即使Scope设置为隔离作用域),
  • 上面代码中的{{name}}是依赖于父作用域的,仍然能被渲染出来,就说明了这点。
  • 我们再看看生成的html为下图所示,可以发现文本“你看不见我”消失了,这是因为被transclude内容替换掉了。 这里的transclude内容就是{{name}}.
  • 接下来再来看看transclude的另一个取值transclude:“element”,那transclude:“element”与transclude:true有什么区别呢?区别在于嵌入的内容,以上面的例子来说,
  • 当transclude:true时候,嵌入的内容为{{name}},
  • 而当transclude:“element”时候,嵌入的内容为

<hello-world> {{name}} </hello-world> 没错,此时嵌入的内容为整个元素。 - 注意:在一个指令的模板template上只能申明一个ng-transclude。 OK,那么现在问题来了,如果我们想把嵌入部分多次放入我们的模板中要怎么办? - 则可以使用$transclude - 或者可以使用compile函数,里面有个transcludeFn参数 - 或者使用link链接函数。 ### controller - 可以是一个字符串或者函数。 - 若是为字符串,则将字符串当做是控制器的名字,来查找注册在应用中的控制器的构造函数 ```js angular.module('myApp', []) .directive('myDirective', function() { restrict: 'A', // 始终需要 controller: 'SomeController' }) // 应用中其他的地方,可以是同一个文件或被index.html包含的另一个文件 angular.module('myApp') .controller('SomeController', function($scope, $element, $attrs, $transclude) { // 控制器逻辑放在这里 }); 也可以直接在指令内部的定义为匿名函数,同样我们可以再这里注入任何服务($log,$timeout等等)

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

另外还有一些特殊的服务(参数)可以注入

(1)$scope,与指令元素相关联的作用域

(2)$element,当前指令对应的 元素

(3)$attrs,由当前元素的属性组成的对象

(4)$transclude,嵌入链接函数,实际被执行用来克隆元素和操作DOM的函数

- 注意: 除非是用来定义一些可复用的行为,一般不推荐在这使用。
指令的控制器和link函数(后面会讲)可以进行互换。区别在于,控制器主要是用来提供可在指令间复用的行为但link链接函数只能在当前内部指令中定义行为,且无法再指令间复用。
html代码:  
```js 
<my-site site="http://www.cnblogs.com/cunjieliu">雷锋叔叔的博客</my-site>
js代码:
  <script>
    angular.module('myApp',[]).directive('mySite', function () {
     return {
         restrict: 'EA',
         transclude: true, //注意此处必须设置为true
         controller:
         function ($scope, $element,$attrs,$transclude,$log) {  //在这里你可以注入你想注入的服务
             $transclude(function (clone) {              
                 var a = angular.element('<a>');
                 a.attr('href', $attrs.site);
                 a.text(clone.text());
                 $element.append(a);
             });
             $log.info("hello everyone");
         }
     };
 });
  </script>

require(字符串或者数组)

  • 字符串代表另一个指令的名字,它将会作为link函数的第四个参数
  • 具体用法可以举个例子说明 假设现在我们要编写两个指令,两个指令中的link链接函数中存在有很多重合的方法, 这时候我们就可以将这些重复的方法写在第三个指令的controller中(controller经常用来提供指令间的复用行为)

然后在这两个指令中,require这个拥有controller字段的的指令(第三个指令), 最后通过link链接函数的第四个参数就可以引用这些重合的方法了。

<!doctype html>
<html ng-app="myApp">
<head>
  <script src="http://cdn.staticfile.org/angular.js/1.2.10/angular.min.js"></script>
</head>
<body>  
  <outer-directive>
     <inner-directive></inner-directive>
     <inner-directive2></inner-directive2>
  </outer-directive>
  <script>
    var app = angular.module('myApp', []);
    app.directive('outerDirective', function() {
          return {
               scope: {},
               restrict: 'AE',
               controller: function($scope) {      
                  this.say = function(someDirective) { 
                     console.log('Got:' + someDirective.message);
                  };
               }
           };
    });
    app.directive('innerDirective', function() {
          return {
               scope: {},
               restrict: 'AE',
               require: '^outerDirective',
               link: function(scope, elem, attrs, controllerInstance) {
                       scope.message = "Hi,leifeng";
                       controllerInstance.say(scope);
               }
          };
    });
    app.directive('innerDirective2', function() {
          return {
               scope: {},
               restrict: 'AE',
               require: '^outerDirective',
               link: function(scope, elem, attrs, controllerInstance) {
                       scope.message = "Hi,shushu";
                       controllerInstance.say(scope);
               }
          };
    });
  </script>
</body>
</html>

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

也进一步说明了,指令中的controller是用来让不同指令间通信用的。

另外我们可以在require的参数值加上下面的某个前缀,这会改变查找控制器的行为:

(1)没有前缀,指令会在自身提供的控制器中进行查找,如果找不到任何控制器,则会抛出一个error

(2)?如果在当前的指令没有找到所需的控制器,则会将null传给link连接函数的第四个参数

(3)^如果在当前的指令没有找到所需的控制器,则会查找父元素的控制器

(4)?^组合

本文转载自:https://my.oschina.net/u/1992917/blog/406421

共有 人打赏支持
专业花农-业余码农
粉丝 0
博文 1
码字总数 0
作品 0
昌平
【前端】—聊聊我认识的Angular

前言 最近接触的项目前端用到了Angular框架,之前略有耳闻,从vue换到Angular,感觉东西差不多,还是要系统学习的,先来了解下。 正文 1、Angular 的发展 AngularJS 是一款来自Google的前端J...

zt15732625878 ⋅ 05/19 ⋅ 0

[Angular Material完全攻略] Day 02 - 环境设定 & 安装 & Hello World

今天我们将开始正式迈入Angular Material的世界,要学习使用Angular Material打造高品质及高质感的网页,当然要从安装Angular Material套件开始,本篇文章就来介绍基本的Angular Material安装...

readilen ⋅ 05/21 ⋅ 0

Difference between Constructor and ngOnInit

The is a default method of the class that is executed when the class is instantiated and ensures proper initialization of fields in the class and its subclasses. Angular or bett......

一真的鱼 ⋅ 05/27 ⋅ 0

JavaScript MVW 框架 - AngularJS

Angular JS (Angular.JS) 是一组用来开发 Web 页面的框架、模板以及数据绑定和丰富 UI 组件。它支持整个开发进程,提供 Web 应用的架构,无需进行手工 DOM 操作。 AngularJS 很小,只有 60K,...

匿名 ⋅ 2011/01/20 ⋅ 44

历经 35 个版本迭代,NG-ZORRO 1.0.0 正式发布

10个月之前我们发布了 NG-ZORRO 的第一个版本,在这 10个月的时间里,我们接收了超过 35 个 contributor 的 386 次 Commit。 在经过了 35 个版本的迭代之后,1.0 版本在今天正式发布。 1.0 ...

GuoMengYue ⋅ 06/11 ⋅ 12

再谈angularJS数据绑定机制及背后原理—angularJS常见问题总结

Angular 的数据绑定采用什么机制,详述原理? 脏检查机制。阐释脏检查机制,必须先了解如下问题。 单向绑定(ng-bind) 和 双向绑定(ng-model) 的区别? ng-bind 单向数据绑定($scope ->...

634117608 ⋅ 04/19 ⋅ 0

Angular 6.0正式版发布,都有哪些新功能

点击关注异步图书,置顶公众号 每天与你分享IT好书 技术干货 职场知识 在Angular 5发布半年之后,Angular 6在昨天正式发布,那么在这个版本有哪些新功能呢?新版本重点关注工具链以及工具链在...

异步社区 ⋅ 05/08 ⋅ 0

Angular 6正式版发布,都有哪些新功能

在Angular 5发布半年之后,Angular 6在昨天正式发布,那么在这个版本有哪些新功能呢?新版本重点关注工具链以及工具链在 Angular 中的运行速度问题。除此之外,这次更新还包括框架包(@angu...

code_xzh ⋅ 05/05 ⋅ 0

初学angular 看到网上有angular js 也有angular2 ,到angular官网发现最近版本是6了,那么现在大家说的angular js到底是什么啊?

初学angular 看到网上有angular js 也有angular2 ,到angular官网发现最近版本是6了,那么现在大家说的angular js到底是什么啊? angular2和现在官网的angular6 就是 angular js 只是版本不同...

Jordan裔 ⋅ 05/19 ⋅ 0

[Angular Material完全攻略] Day 01 - 开始 & 简介

转载 从Angular第2版正式release后,根据全球最大工程师讨论区StackOverflow的统计,从2016开始的Angular讨论度就不断窜升,甚至超越了React,直到了2017年,甚至摆脱了前一代Angularjs的阴影...

readilen ⋅ 05/21 ⋅ 0

没有更多内容

加载失败,请刷新页面

加载更多

下一页

6.1 压缩打包介绍 6.2 gzip压缩工具 6.3 bzip2压缩工具 6.4 xz压缩工具

压缩打包介绍 使用压缩工具的好处: 使用压缩文件,不仅可以节省磁盘空间,而且在传输时还能节省网络宽带。 我们通常讲的家用宽带和机房宽带100M是有区别的: 机房宽带的上行和下行都是100M,...

Linux_老吴 ⋅ 28分钟前 ⋅ 0

SpringBoot热部署加持

概述 进行SpringBoot的Web开发过程中,我们很多时候经常需要重启Web服务器才能保证修改的 源代码文件、或者一些诸如xml的配置文件、以及一些静态文件生效,这样耗时又低效。所谓的热部署指的...

CodeSheep ⋅ 34分钟前 ⋅ 0

OSChina 周六乱弹 —— 假如你被熊困到树上

Osc乱弹歌单(2018)请戳(这里) 【今日歌曲】 @小小编辑:推荐歌曲《如果写不出好的和弦就该在洒满阳光的钢琴前一起吃布丁》 《如果写不出好的和弦就该在洒满阳光的钢琴前一起吃布丁》- 谢...

小小编辑 ⋅ 今天 ⋅ 5

vbs 取文件大小 字节

dim namedim fs, s'name = Inputbox("姓名")'msgbox(name)set fs = wscript.createobject("scripting.filesystemobject") 'fs为FSO实例if (fs.folderexists("c:\temp"))......

vga ⋅ 今天 ⋅ 1

高并发之Nginx的限流

首先Nginx的版本号有要求,最低为1.11.5 如果低于这个版本,在Nginx的配置中 upstream web_app { server 到达Ip1:端口 max_conns=10; server 到达Ip2:端口 max_conns=10; } server { listen ...

算法之名 ⋅ 今天 ⋅ 0

Spring | IOC AOP 注解 简单使用

写在前面的话 很久没更新笔记了,有人会抱怨:小冯啊,你是不是在偷懒啊,没有学习了。老哥,真的冤枉:我觉得我自己很菜,还在努力学习呢,正在学习Vue.js做管理系统呢。即便这样,我还是不...

Wenyi_Feng ⋅ 今天 ⋅ 0

博客迁移到 https://www.jianshu.com/u/aa501451a235

博客迁移到 https://www.jianshu.com/u/aa501451a235 本博客不再更新

为为02 ⋅ 今天 ⋅ 0

win10怎么彻底关闭自动更新

win10自带的更新每天都很多,每一次下载都要占用大量网络,而且安装要等得时间也蛮久的。 工具/原料 Win10 方法/步骤 单击左下角开始菜单点击设置图标进入设置界面 在设置窗口中输入“服务”...

阿K1225 ⋅ 今天 ⋅ 0

Elasticsearch 6.3.0 SQL功能使用案例分享

The best elasticsearch highlevel java rest api-----bboss Elasticsearch 6.3.0 官方新推出的SQL检索插件非常不错,本文一个实际案例来介绍其使用方法。 1.代码中的sql检索 @Testpu...

bboss ⋅ 今天 ⋅ 0

informix数据库在linux中的安装以及用java/c/c++访问

一、安装前准备 安装JDK(略) 到IBM官网上下载informix软件:iif.12.10.FC9DE.linux-x86_64.tar放在某个大家都可以访问的目录比如:/mypkg,并解压到该目录下。 我也放到了百度云和天翼云上...

wangxuwei ⋅ 今天 ⋅ 0

没有更多内容

加载失败,请刷新页面

加载更多

下一页

返回顶部
顶部