AngularJS指令(Directives)实践指南

指令(Directives)是所有AngularJS应用最重要的部分。尽管AngularJS已经提供了非常丰富的指令,但还是经常需要创建应用特定的指令。这篇教程会为你讲述如何自定义指令,以及介绍如何在实际项目中使用。在这篇文章的***(第二部分),我会指导你如何使用Angular指令来创建一个简单的记事本应用。

创新互联建站-专业网站定制、快速模板网站建设、高性价比娄底网站开发、企业建站全套包干低至880元,成熟完善的模板库,直接使用。一站式娄底网站制作公司更省心,省钱,快速模板网站建设找我们,业务覆盖娄底地区。费用合理售后完善,10余年实体公司更值得信赖。

概述

一个指令用来引入新的HTML语法。指令是DOM元素上的标记,使元素拥有特定的行为。举例来说,静态的HTML不知道如何来创建和展现一个日期选择器控件。让HTML能识别这个语法,我们需要使用指令。指令通过某种方法来创建一个能够支持日期选择的元素。我们会循序渐进地介绍这是如何实现的。 如果你写过AngularJS的应用,那么你一定已经使用过指令,不管你有没有意识到。你肯定已经用过简单的指令,比如 ng-mode, ng-repeat, ng-show等。这些指令都赋予DOM元素特定的行为。例如,ng-repeat 重复特定的元素,ng-show 有条件地显示一个元素。如果你想让一个元素支持拖拽,你也需要创建一个指令来实现它。指令背后基本的想法很简单。它通过对元素绑定事件监听或者改变DOM而使HTML拥有真实的交互性。

jQuery视角

想象一下使用jQuery如何创建一个日期选择器。首先,我们在HTML中添加一个普通的输入框,然后通过jQuery调用 $(element).dataPicker() 来将它转变成一个日期选择器。但是,仔细想一下。当一个设计人员过来检查HTML标记的时候,他/她能否立刻猜到这个字段实际上表示的内容?这只是一个简单的输入框,或者一个日期选择器?你需要查看jQuery代码来确定这些。而Angular的方法是使用一个指令来扩展HTML。所以,一个日期选择器的指令可以是下面的形式:

 
 
  1.  

或者是这样:

 
 
  1.  

这种创建UI组建的方式更加直接和清晰。你可以轻易地通过查看元素就明白这到底是什么。

创建自定义指令:

一个Angular指令可以有以下的四种表现形式: 1. 一个新的HTML元素() 2. 元素的属性() 3. CSS class() 4. 注释() 当然,我们可以控制我们的指令在HTML中的表现形式。下面我们来看一下AngularJS中的一个典型的指令的写法。指令注册的方式与 controller 一样,但是它返回的是一个拥有指令配置属性的简单对象(指令定义对象) 。下面的代码是一个简单的 Hello World 指令。

 
 
  1. var app = angular.module('myapp', []);  
  2.    
  3. app.directive('helloWorld', function() {  
  4.   return {  
  5.       restrict: 'AE',  
  6.       replace: 'true',  
  7.       template: '

    Hello World!!

  8.   };  
  9. });  

在上面的代码中,app.directive()方法在模块中注册了一个新的指令。这个方法的***个参数是这个指令的名字。第二个参数是一个返回指令定义对象的函数。如果你的指令依赖于其他的对象或者服务,比如 $rootScope, $http, 或者$compile,他们可以在这个时间被注入。这个指令在HTML中以一个元素使用,如下:

 
 
  1.  
  2. //OR  
  3.  

或者,以一个属性的方式使用:

 
 
 
  • //OR  
  •  
  • 如果你想要符合HTML5的规范,你可以在元素前面添加 x- 或者 data-的前缀。所以下面的标记也会匹配 helloWorld 指令:

     
     
     
  • //OR  
  •  

    注意: 在匹配指令的时候,Angular会在元素或者属性的名字中剔除 x- 或者 data- 前缀。 然后将 – 或者 : 连接的字符串转换成驼峰(camelCase)表现形式,然后再与注册过的指令进行匹配。这是为什么,我们在HTML中以 hello-world 的方式使用 helloWorld 指令。其实,这跟HTML对标签和属性不区分大小写有关。 尽管上面的指令仅仅实现了静态文字的显示,但是这里还是有一些有趣的点值得我们去挖掘。我们在指令定义过程中使用了三个属性来配置指令。我们来一一介绍他们的作用。

    打开这个 plunker,在”Hello World!!”右键检查元素内容,来更形象地明白这些。

    Link函数和Scope

    指令生成出的模板其实没有太多意义,除非它在特定的scope下编译。默认情况下,指令并不会创建新的子scope。更多的,它使用父scope。也就是说,如果指令存在于一个controller下,它就会使用这个controller的scope。 如何运用scope,我们要用到一个叫做 link 的函数。它由指令定义对象中的link属性配置。让我们来改变一下我们的 helloWorld 指令,当用户在一个输入框中输入一种颜色的名称时,Hello World 文字的背景色自动发生变化。同时,当用户在 Hello World 文字上点击时,背景色变回白色。 相应的HTML标记如下:

     
     
    1.  
    2.     
    3.     
    4.  

    修改后的 helloWorld 指令如下:

     
     
    1. app.directive('helloWorld', function() {  
    2.   return {  
    3.     restrict: 'AE',  
    4.     replace: true,  
    5.     template: 'Hello World',  
    6.     link: function(scope, elem, attrs) {  
    7.       elem.bind('click', function() {  
    8.         elem.css('background-color', 'white');  
    9.         scope.$apply(function() {  
    10.           scope.color = "white";  
    11.         });  
    12.       });  
    13.       elem.bind('mouseover', function() {  
    14.         elem.css('cursor', 'pointer');  
    15.       });  
    16.     }  
    17.   };  
    18. });  

    我们注意到指令定义中的 link 函数。 它有三个参数:

    link函数主要用来为DOM元素添加事件监听、监视模型属性变化、以及更新DOM。在上面的指令代码片段中,我们添加了两个事件, click,和 mouseover。click 处理函数用来重置

    的背景色,而 mouseover 处理函数改变鼠标为 pointer。在模板中有一个表达式 {{color}},当父scope中的 color 发生变化时,它用来改变 Hello World 文字的背景色。 这个 plunker 演示了这些概念。

    #p#

    compile函数

    compile 函数在 link 函数被执行之前用来做一些DOM改造。它接收下面的参数:

    要注意的是 compile 函数不能访问 scope,并且必须返回一个 link 函数。但是如果没有设置 compile 函数,你可以正常地配置 link 函数,(有了compile,就不能用link,link函数由compile返回)。compile函数可以写成如下的形式:

     
     
    1. app.directive('test', function() {  
    2.   return {  
    3.     compile: function(tElem,attrs) {  
    4.       //do optional DOM transformation here  
    5.       return function(scope,elem,attrs) {  
    6.         //linking function here  
    7.       };  
    8.     }  
    9.   };  
    10. });  

    大多数的情况下,你只需要使用 link 函数。这是因为大部分的指令只需要考虑注册事件监听、监视模型、以及更新DOM等,这些都可以在 link 函数中完成。 但是对于像 ng-repeat 之类的指令,需要克隆和重复 DOM 元素多次,在 link 函数执行之前由 compile 函数来完成。这就带来了一个问题,为什么我们需要两个分开的函数来完成生成过程,为什么不能只使用一个?要回答好这个问题,我们需要理解指令在Angular中是如何被编译的!

    指令是如何被编译的

    当应用引导启动的时候,Angular开始使用 $compile 服务遍历DOM元素。这个服务基于注册过的指令在标记文本中搜索指令。一旦所有的指令都被识别后,Angular执行他们的 compile 方法。如前面所讲的,compile 方法返回一个 link 函数,被添加到稍后执行的 link 函数列表中。这被称为编译阶段。如果一个指令需要被克隆很多次(比如 ng-repeat),compile函数只在编译阶段被执行一次,复制这些模板,但是link 函数会针对每个被复制的实例被执行。所以分开处理,让我们在性能上有一定的提高。这也说明了为什么在 compile 函数中不能访问到scope对象。 在编译阶段之后,就开始了链接(linking)阶段。在这个阶段,所有收集的 link 函数将被一一执行。指令创造出来的模板会在正确的scope下被解析和处理,然后返回具有事件响应的真实的DOM节点。

    改变指令的Scope

    默认情况下,指令获取它父节点的controller的scope。但这并不适用于所有情况。如果将父controller的scope暴露给指令,那么他们可以随意地修改 scope 的属性。在某些情况下,你的指令希望能够添加一些仅限内部使用的属性和方法。如果我们在父的scope中添加,会污染父scope。 其实我们还有两种选择:

    这样的scope可以通过指令定义对象中 scope 属性来配置。下面的代码片段是一个例子:

     
     
    1. app.directive('helloWorld', function() {  
    2.   return {  
    3.     scope: true,  // use a child scope that inherits from parent  
    4.     restrict: 'AE',  
    5.     replace: 'true',  
    6.     template: '

      Hello World!!

    7.   };  
    8. });  

    上面的代码,让Angular给指令创建一个继承自父socpe的新的子scope。 另外一个选择,隔离的scope:

     
     
    1. app.directive('helloWorld', function() {  
    2.   return {  
    3.     scope: {},  // use a new isolated scope  
    4.     restrict: 'AE',  
    5.     replace: 'true',  
    6.     template: '

      Hello World!!

    7.   };  
    8. });  

    这个指令使用了一个隔离的scope。隔离的scope在我们想要创建可重用的指令的时候是非常有好处的。通过使用隔离的scope,我们能够保证我们的指令是自包含的,可以被很容易的插入到HTML应用中。 它内部不能访问父的scope,所保证了父scope不被污染。 在我们的 helloWorld 指令例子中,如果我们将 scope 设置成 {},那么上面的代码将不会工作。 它会创建一个新的隔离的scope,那么相应的表达式 {{color}} 会指向到这个新的scope中,它的值将是 undefined. 使用隔离的scope并不意味着我们完全不能访问父scope的属性。其实有一些技术可以允许我们访问父scope的属性,甚至监视他们的变化。我们会在指令这个系列的第二部分中讨论这些技术,以及一些更高级的概念,比如 Controller 函数。 第二部分也会和你一起使用Angular指令创建一个较为丰富的记事本应用。 所以,请保持关注。

    原文链接: sitepoint   翻译: 伯乐在线 - 陈 鑫伟

    译文链接: http://blog.jobbole.com/62249/

    本文标题:AngularJS指令(Directives)实践指南
    转载源于:http://www.36103.cn/qtweb/news22/1522.html

    网站建设、网络推广公司-创新互联,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等

    广告

    声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联

    猜你还喜欢下面的内容

    定制开发知识

    各行业网站