angular directive

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

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

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

angular.module("app",[]).directive("hello",function(){
                return{
                 restrict:'EA',
                 replace：true,
                 template:"<div><h3>hello world</h3></div>"
                };
            })

HTML代码为：
<hello></hello>

渲染以后的代码：<div><h3>hello world</h3></div>

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

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

7.scope

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

（1）默认值false。

表示继承父做用域;

（2）true

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

（3）{}

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

8.transclude

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

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

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

9.controller

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

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

10.controllerAs

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

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

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

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

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

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

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

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