angularJS directive详解（自定义指令）

Angularjs指令定义的API

 AngularJs的指令定义大体以下

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

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-->

例如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文本

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

其中tElement是指使用此指令的元素，而tAttrs则实例的属性，它是一个由元素上全部的属性组成的集合（对象）形如：

下面让咱们看看template是一个函数时候的状况

由于一段HTML文本，阅读跟维护起来都是很麻烦的，所用一般会使用templateUrl这个。

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

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

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

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

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

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

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

另外一种办法缓存是:

6.replace

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

对比下没有开启replace时候的渲染出来的HTML。发现<hello></hello>不见了。

另外当模板为纯文本（即template:"wo shi wen ben"）的时候，渲染以后的html代码默认的为文本用span包含。

7.scope

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

（1）默认值false。

表示继承父做用域;

（2）true

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

（3）{}

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

7.1首先咱们先来了解下scope的继承机制。咱们用ng-controller这个指令举例，

咱们都知道ng-controller（内置指令）能够从父做用域中继承而且建立一个新的子做用域。以下：

这时页面显示是

parentNode：父亲

chrildNode： 儿子

若去掉

则显示

parentNode：父亲

chrildNode： 父亲

注意：

1）若一个元素上有多个指令，使用了隔离做用域，则只有其中一个能够生效；

2）只有指令模板中的根元素才能得到一个新的做用域，这时候，scope就被设置为true了；

 

 

页面显示为：

parentNode：父亲

chrildNode： cunjieliu

孙女

上面中class为one那个div得到了指令ng-controller=’myController‘所建立的新的做用域；

而class为two那个div得到了指令ng-controller=’myController2‘所建立的新的做用域；

这就是“只有指令模板中的根元素才能得到一个新的做用域”；

 

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

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

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

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

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

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

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

下面看一个例子

可是，但咱们将scope设置为{}时候，再次运行上面的代码能够发现页面并不能成功完整显示！

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

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

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

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

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

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

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

而后你能够看到表达式{{color}}被赋值给了color-attr。

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

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

这里须要注意的是，咱们要直接在指令运行的那个元素上设置属性时候，是直接将 实际的做用域模型 赋值给该属性（这里就是color）

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

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

运行以后，弹出alert框。

8.transclude

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

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

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

运行上面的代码，输出

china

leifeng

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

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

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

这里的transclude内容就是{{name}}

接下来再来看看transclude的另外一个取值transclude：“element”

那transclude：“element”与transclude：true有什么区别呢？

区别在于嵌入的内容，以上面的例子来讲，

当transclude：true时候，嵌入的内容为{{name}}，

而当transclude：“element”时候，嵌入的内容为

注：本文系转载，我的感受写的比较详细，拿来分享。