学习AngularJs:Directive指令用法（完整版）
前端之家收集整理的这篇文章主要介绍了
学习AngularJs:Directive指令用法（完整版），
前端之家小编觉得挺不错的，现在分享给大家，也给大家做个参考。
本教程使用AngularJs版本：1.5.3
AngularJs GitHub:
AngularJs下载地址：
Directive（指令）笔者认为是AngularJ非常强大而有有用的
功能之一。它就相当于为我们写了公共的
自定义DOM元素或CLASS
属性或ATTR
属性，并且它不只是单单如此，你还可以在它的基础上来操作scope、绑定事件、更改样式等。通过这个Directive，我们可以封装很多公共指令，比如
分页指令、
自动补全指令等等。然后在HTML
页面里只需要简单的写一行
代码就可以实现很多强大的
功能。一般情况下，需要用Directive有下面的情景：
1. 使你的Html更具语义化，不需要深入研究
代码和逻辑即可知道
页面的大致逻辑。
2. 抽象一个
自定义组件，在其他地方进行重用。
一、Directive的定义及其使用方法
AngularJs的指令定义大致如下
Directive可以放置于元素名、属性、class、注释中。下面是引用myDir这个directive的等价方式。（但很多directive都限制为“属性”的使用方式）
//属性
<span class="<span style="font-family: Arial,sans-serif;">directive-name: exp;">//class
<<span style="font-family: Arial,sans-serif;">directive-name></<span style="font-family: Arial,sans-serif;">directive-name>//元素
//注释
如下一个实例 ：
<
Meta charset="UTF-8">
AngularJS入门学习
结果：
下面是一个directive的详细版
myModule.directive('directiveName',function factory(injectables) {
var directiveDefinitionObject = {
priority: 0, template: '
', templateUrl: 'directive.html', replace: false, transclude: false, restrict: 'A', scope: false, compile: function compile(tElement,tAttrs,transclude) {
return {
pre: function preLink(scope,iElement,iAttrs,controller) { ... }, post: function postLink(scope,controller) { ... }
}
}, link: function postLink(scope,iAttrs) { ... }
};
return directiveDefinitionObject;
});
二、Directive指令内容解读
可 以看到它有8个
内容
1.restrict
（字符串）可选参数，指明指令在DOM里面以什么形式被声明；取值有：E(元素),A(属性),C(类),M(注释)，其中默认值为A；当然也可以两个一起用，比如EA.表示即可以是元素也可以是属性。
[html] view plain copy 在CODE上查看代码片派生到我的代码片
E(元素)：
A(属性)：
C(类)：
M(注释)：<--directive:directiveName expression-->
一般情况下E/A/C用得比较多。
2.priority
(数字)，可选参数，指明指令的优先级，若在单个DOM上有多个指令，则优先级高的先执行；
3.terminal
（布尔型），可选参数，可以被设置为true或false，若设置为true，则优先级低于此指令的其他指令则无效，不会被调用(优先级相同的还是会执行)
4.template（字符串或者函数）可选参数，可以是：
（1）一段HTML文本
<
Meta charset="UTF-8">
AngularJS入门学习
（2）一个函数，可接受两个参数tElement和tAttrs
其中tElement是指使用此指令的元素，而tAttrs则实例的属性，它是一个由元素上所有的属性组成的集合（对象）形如：
其中title就是tattrs上的属性
下面让我们看看template是一个函数时候的情况
<
Meta charset="UTF-8">
AngularJS入门学习
结果：
可以看到指令中还用到了hello-world2中的标签中的 title字段
5.templateUrl（字符串或者函数），可选参数，可以是
（1）一个代表HTML文件路径的字符串
（2）一个函数，可接受两个参数tElement和tAttrs（大致同上）
注意：在本地开发时候，需要运行一个服务器，不然使用templateUrl会报错 Cross Origin Request Script（CORS）错误。由于加载html模板是通过异步加载的，若加载大量的模板会拖慢网站的速度，这里有个技巧，就是先缓存模板
你可以再你的index页面加载好的，将下列代码作为你页面的一部分包含在里面。
这里的id属性就是被设置在templateUrl上用的。
<
Meta charset="UTF-8">
AngularJS入门学习
输出结果：
另一种办法缓存是:
Hi 我是林炳文~~~
");
}]);
使用实例如下：
<
Meta charset="UTF-8">
AngularJS入门学习
结果：
其实第一种方法还好一些，写起来会比较快，笔者就得最多的也是第一种写法，直接包在scprit当中
6.replace
（布尔值），默认值为false，设置为true时候，我们再来看看下面的例子（对比下在template时候举的例子）
replace为true时，hello-world这个标签不在了，反之，则存在。
7.scope
（1）默认值false。表示继承父作用域;
（2）true。表示继承父作用域，并创建自己的作用域（子作用域）;
（3）{}。表示创建一个全新的隔离作用域；
7.1首先我们先来了解下scope的继承机制。我们用ng-controller这个指令举例，
<
Meta charset="UTF-8">
AngularJS入门学习
接下来我们通过一个简单明了的例子来说明scope取值不同的差别：
scope:false
scope:true
scope:{}
当为false时候，儿子继承父亲的值，改变父亲的值，儿子的值也随之变化，反之亦如此。（继承不隔离）
当为true时候，儿子继承父亲的值，改变父亲的值，儿子的值随之变化，但是改变儿子的值，父亲的值不变。（继承隔离）
当为{}时候，没有继承父亲的值，所以儿子的值为空，改变任何一方的值均不能影响另一方的值。（不继承隔离）
tip：当你想要创建一个可重用的组件时隔离作用域是一个很好的选择，通过隔离作用域我们确保指令是‘独立'的,并可以轻松地插入到任何HTML app中，并且这种做法防止了父作用域被污染；
7.2隔离作用域可以通过绑定策略来访问父作用域的属性。
directive 在使用隔离 scope 的时候，提供了三种方法同隔离之外的地方交互。这三种分别是
@ 绑定一个局部 scope 属性到当前 dom 节点的属性值。结果总是一个字符串，因为 dom 属性是字符串。
& 提供一种方式执行一个表达式在父 scope 的上下文中。如果没有指定 attr 名称，则属性名称为相同的本地名称。
= 通过 directive 的 attr 属性的值在局部 scope 的属性和父 scope 属性名之间建立双向绑定。
@ 局部 scope 属性
@ 方式局部属性用来访问 directive 外部环境定义的字符串值，主要是通过 directive 所在的标签属性绑定外部字符串值。这种绑定是单向的，即父 scope 的绑定变化，directive 中的 scope 的属性会同步变化，而隔离 scope 中的绑定变化，父 scope 是不知道的。
如下示例：directive 声明未隔离 scope 类型，并且使用@绑定 name 属性，在 directive 中使用 name 属性绑定父 scope 中的属性。当改变父 scope 中属性的值的时候，directive 会同步更新值，当改变 directive 的 scope 的属性值时，父 scope 无法同步更新值。
js 代码：
<
Meta charset="UTF-8">
AngularJS入门学习
结果：页面初始效果
动画效果：
可以看到父scope上的内容发生改变，子scope同时发生改变。而子scope上的内容发生改变。不影响父scope上的内容！
= 局部 scope 属性
= 通过 directive 的 attr 属性的值在局部 scope 的属性和父 scope 属性名之间建立双向绑定。
意思是，当你想要一个双向绑定的属性的时候，你可以使用=来引入外部属性。无论是改变父 scope 还是隔离 scope 里的属性，父 scope 和隔离 scope 都会同时更新属性值，因为它们是双向绑定的关系。
示例代码：
<
Meta charset="UTF-8">
AngularJS入门学习
效果：
可以看到父scope和子scope上的内容一直都是一样的！
& 局部 scope 属性
& 方式提供一种途经是 directive 能在父 scope 的上下文中执行一个表达式。此表达式可以是一个 function。
比如当你写了一个 directive，当用户点击按钮时，directive 想要通知 controller，controller 无法知道 directive 中发生了什么，也许你可以通过使用 angular 中的 event 广播来做到，但是必须要在 controller 中增加一个事件监听方法。
最好的方法就是让 directive 可以通过一个父 scope 中的 function，当 directive 中有什么动作需要更新到父 scope 中的时候，可以在父 scope 上下文中执行一段代码或者一个函数。
如下示例在 directive 中执行父 scope 的 function。
<
Meta charset="UTF-8">
AngularJS入门学习
效果：
内容比较多，下面再来讲讲transclude、compline、link、contrller
8.transclude
如果不想让指令内部的内容被模板替换，可以设置这个值为true。一般情况下需要和ngTransclude指令一起使用。 比如：template:"
"，这时，指令内部的
内容会嵌入到ng-transclude这个div中。也就是变成了
。默认值为false；这个配置选项可以让我们
提取包含在指令那个元素里面的
内容，再将它放置在指令模板的特定位置。当你开启transclude后，你就可以使用ng-transclude来指明了应该在什么地方放置transcluded
内容
<
Meta charset="UTF-8">
AngularJS入门学习
结果：
当 transclude: false,时
如果指令使用了transclude参数，那么在控制器无法正常监听数据模型的变化了。建议在链接函数里使用$watch服务。
9.controller
可以是一个字符串或者函数。
若是为字符串，则将字符串当做是控制器的名字，来查找注册在应用中的控制器的构造函数
文件或被index.html包含的另一个
文件
angular.module('myApp')
.controller('SomeController',function($scope,$element,$attrs,$transclude) {
// 控制器逻辑放在这里
});
也可以直接在指令内部的定义为匿名
函数，同样我们可以再这里注入任何服务（$log,$timeout等等）
[html] view plain copy 在CODE上查看代码片派生到我的代码片
angular.module('myApp',controller:
function($scope,$transclude) {
// 控制器逻辑放在这里
}
});
另外还有一些特殊的服务（参数）可以注入
（1）$scope，与指令元素相关联的作用域
（2）$element，当前指令对应的 元素
（3）$attrs，由当前元素的属性组成的对象
（4）$transclude，嵌入链接函数，实际被执行用来克隆元素和操作DOM的函数
注意：
除非是用来定义一些可复用的行为，一般不推荐在这使用。
指令的控制器和link
函数（后面会讲）可以进行互换。区别在于，控制器主要是用来提供可在指令间复用的行为但link
链接函数只能在当前内部指令中定义行为，且无法再指令间复用。
<
Meta charset="UTF-8">
AngularJS入门学习
输出结果：
并且在控制台下输出hello everyone
让我们看看$transclude();在这里，它可以接收两个参数，第一个是$scope，作用域，第二个是带有参数clone的回调函数。而这个clone实际上就是嵌入的内容（经过jquery包装），可以在它上做很多DOM操作。
它还有最简单的用法就是
angular.module('myApp',[]).directive('mySite',function () {
return {
restrict: 'EA',controller:
function ($scope,$log) {
var a = $transclude(); //$transclude()就是嵌入的
内容
$element.append(a);
}
};
});
注意：使用$transclude会生成一个新的作用域。
默认情况下，如果我们简单实用$transclude()，那么默认的其作用域就是$transclude生成的作用域
但是如果我们实用$transclude($scope,function(clone){}),那么作用域就是directive的作用域了
那么问题又来了。如果我们想实用父作用域呢
可以使用$scope.$parent
同理想要一个新的作用域也可以使用$scope.$parent.new()；
10.controllerAs
这个选项的作用是可以设置你的控制器的别名
一般以前我们经常用这样方式来写代码：
<div ng-app="app" ng-controller="demoController">
{{title}}
