AngularJS 自定义指令详解 标签： 自定义指令的参数linktemplateUrlscopeAngularJS 自定义指令详解 2016-08-20 15:02 3831人阅读 评论(1)
2017-07-18 11:09
525 查看
AngularJS 自定义指令详解
标签： 自定义指令的参数linktemplateUrlscopeAngularJS自定义指令详解
除了 AngularJS 内置的63个指令外，我们还可以创建自定义指令。你可以使用
.directive 函数来添加自定义的指令。要调用自定义指令，HTML 元素上需要添加自定义指令名。使用驼峰法来命名一个指令， runoobDirective, 但在使用它时需要以 - 分割, runoob-directive，自定义指令的参数如下：
[javascript] view
plain copy
angular.module('app', []).directive('myDirective', function() {
return {
restrict:String,
priority:Number,
terminal:Boolean,
template:String or Template Function,
templateUrl:String or Template Function,
replace:Boolean or String,
transclude:Boolean,
scope:Boolean or Object,
controller:String or function(scope, element, attrs, transclude, otherInjectables) { ... },
controllerAs:String,
require:String,
link: function(scope, iElement, iAttrs) { ... },
compile:function(tElement, tAttrs, transclude) {
return {
pre: function(scope, iElement, iAttrs, controller) { ... },
post: function(scope, iElement, iAttrs, controller) { ... }
}
return function postLink(...) { ... }
}
};
});
1、restrict：String
restrict是申明标识符在模板中作为元素，属性，类，注释或组合，如何使用。有四个值：E、A、C、M
注意：
（1）、推荐使用元素和属性的方式使用指令
（2）、当需要创建带有自己的模板的指令时，使用元素名称的方式创建指令
（3）、当需要为已有的HTML标签增加功能时，使用属性的方式创建指令
实例：
[html] view
plain copy
<!doctype html>
<html ng-app="MyModule">
<head>
<meta charset="utf-8">
</head>
<body>
<hello></hello>
<div hello></div>
<div class="hello"></div>
<!-- directive:hello -->
</body>
<script src="framework/angular-1.3.0.14/angular.js"></script>
<script>
var myModule = angular.module("MyModule", []);
myModule.directive("hello", function() {
return {
restrict: 'AEMC',
template: '<div>Hi everyone!</div>',
replace: true
}
});
</script>
</html>
2、priority: Number
priority是指令执行优先级。若在单个DOM上有多个指令，则优先级高的先执行；
设置指令的优先级算是不常用的
3、template: String or Function
（1）、字符串
template是指令链接DOM模板
[html] view
plain copy
<!doctype html>
<html ng-app="MyModule">
<head>
<meta charset="utf-8">
</head>
<body>
<hello></hello>
</body>
<script src="framework/angular-1.3.0.14/angular.js"></script>
<script>
var myModule = angular.module("MyModule", []);
myModule.directive("hello", function() {
return {
restrict: 'E',
template: '<div>hello world</div>',
replace: true
}
});
</script>
</html>
（2）、函数
Function一个函数，可接受两个参数tElement和tAttrs。其中tElement是指使用此指令的元素，而tAttrs则实例的属性，它是一个由元素上所有的属性组成的集合（对象）形如：
[html] view
plain copy
{
name:‘shanshuizinong,
age:23
}
[javascript] view
plain copy
<!doctype html>
<html ng-app="MyModule">
<head>
<meta charset="utf-8">
</head>
<body>
<hello name='shanshuizinong'></hello>
</body>
<script src="js/angular.min.js"></script>
<script>
var myModule = angular.module("MyModule", []);
myModule.directive("hello", function() {
return {
restrict: 'E',
replace: true,
template: function(tElement,tAttrs){
var html = '';
html += '<div>'+tAttrs.name+'</div>';
return html;
}
}
});
</script>
</html>
4、emplateUrl: String
templateUrl是指定一个字符串式的内嵌模板，如果你指定了模板是一个URL，那么是不会使用的。
[html] view
plain copy
<!doctype html>
<html ng-app="MyModule">
<head>
<meta charset="utf-8">
<link rel="stylesheet" href="css/bootstrap-3.0.0/css/bootstrap.css">
</head>
<body>
<hello></hello>
</body>
<script src="framework/angular-1.3.0.14/angular.js"></script>
<script type="text/javascript">
var myModule = angular.module("MyModule", []);
myModule.directive("hello", function() {
return {
restrict: 'AECM',
templateUrl: 'hello.html',
replace: true
}
});
</script>
</html>
由于加载html模板是通过异步加载的，若加载大量的模板会拖慢网站的速度，这里有个技巧，就是先缓存模板。
[html] view
plain copy
<!doctype html>
<html ng-app="MyModule">
<head>
<meta charset="utf-8">
</head>
<body>
<hello></hello>
</body>
<script src="framework/angular-1.3.0.14/angular.js"></script>
<script type="text/javascript">
var myModule = angular.module("MyModule", []);
//注射器加载完所有模块时，此方法执行一次;缓存
myModule.run(function($templateCache){
$templateCache.put("hello.html","<div>Hello world!!!</div>");
});
myModule.directive("hello", function($templateCache) {
return {
restrict: 'AECM',
template: $templateCache.get("hello.html"),
replace: true
}
});
</script>
</html>
5、replace: Boolean
replace是指令链接模板是否替换原有元素
[html] view
plain copy
<!doctype html>
<html ng-app="MyModule">
<head>
<meta charset="utf-8">
</head>
<body>
<hello>
<div>这里是指令内部的内容。</div>
</hello>
</body>
<script src="js/angular.min.js" type="text/javascript" charset="utf-8"></script>
<script type="text/javascript">
var myModule = angular.module("MyModule", []);
myModule.directive("hello", function() {
return {
restrict:"AE",
template:"<div>Hello World!</div>",
replace:true
}
});
</script>
</html&
4000
gt;
6、transclude: Boolean
transclude是移动一个标识符的原始字节带到一个新模块的位置。当你开启transclude后，你就可以使用ng-transclude来指明了应该在什么地方放置transcluded内容。
[html] view
plain copy
<!doctype html>
<html ng-app="MyModule">
<head>
<meta charset="utf-8">
</head>
<body>
<hello>
<div>这里是指令内部的内容。</div>
</hello>
</body>
<script src="js/angular.min.js"></script>
<script type="text/javascript">
var myModule = angular.module("MyModule", []);
myModule.directive("hello", function() {
return {
restrict:"AE",
transclude:true,
template:"<div>Hello everyone!<div ng-transclude>你看不见我</div></div>"
}
});
</script>
</html>
7、link：Function
link通过代码修改目标DOM元素的实例，添加事件监听，建立数据绑定。compile函数用来对模板自身进行转换，而link函数负责在模型和视图之间进行动态关联；compile函数仅仅在编译阶段运行一次，而对于指令的每个实例，link函数都会执行一次；compile可以返回preLink和postLink函数，而link函数只会返回postLink函数，如果需要修改DOM结构，应该在postLink中来做这件事情，而如果在preLink中做这件事情会导致错误；大多数时候我们只要编写link函数即可。
link函数有四个参数分别为：
（1）scope，与指令元素相关联的作用域
（2）element，当前指令对应的 元素
（3）attrs，由当前元素的属性组成的对象
（4）supermanCtrl，若指令中定义有require选项，则会有supermanCtrl参数，代表控制器或者所依赖的指令的控制器。
[html] view
plain copy
<!doctype html>
<html ng-app="MyModule">
<head>
<meta charset="utf-8">
</head>
<body>
<hello>Hello World!</hello>
</body>
<script src="js/angular.min.js"></script>
<script type="text/javascript">
var myModule = angular.module("MyModule", []);
myModule.directive("hello", function() {
return {
restrict:"AE",
link:function(scope,element,attrs,supermanCtrl){
console.log(element);
element.bind("mouseenter",function(){
console.log("鼠标进入...");
});
element.bind("mouseout",function(){
console.log("鼠标滑出...");
});
}
}
});
</script>
</html>
下面实例通过link函数实现指令的复用，两个控制器与一个指令之间进行交互。指令可以调用控制器MyCtrl和MyCtrl2中的方法，但是需要注意我们必须使用属性，因为两个控制器的方法不同。
[html] view
plain copy
<!doctype html>
<html ng-app="MyModule">
<head>
<meta charset="utf-8">
</head>
<body>
<div ng-controller="MyCtrl">
<loader howToLoad="loadData()">滑动加载</loader>
</div>
<div ng-controller="MyCtrl2">
<loader howToLoad="loadData2()">滑动加载</loader>
</div>
</body>
<script src="framework/angular-1.3.0.14/angular.js"></script>
<script type="text/javascript">
var myModule = angular.module("MyModule", []);
myModule.controller('MyCtrl', ['$scope', function($scope){
$scope.loadData=function(){
console.log("加载数据中111...");
}
}]);
myModule.controller('MyCtrl2', ['$scope', function($scope){
$scope.loadData2=function(){
console.log("加载数据中222...");
}
}]);
myModule.directive("loader", function() {
return {
restrict:"AE",
link:function(scope,element,attrs){
element.bind('mouseenter', function(event) {
//注意这里的坑，howToLoad会被转换成小写的howtoload
scope.$apply(attrs.howtoload);
});
}
}
});
</script>
</html>
8、controller和require
（1）、controller
controller创建一个控制器通过标识符公开通信API。给指令暴露出一组public方法，给外部调用的。
1）、字符串
若是为字符串，则将字符串当做是控制器的名字，来查找注册在应用中的控制器的构造函数
[javascript] view
plain copy
angular.module('myApp', []) .directive('myDirective', function() {
restrict: 'A',
controller: 'SomeController'
})
angular.module('myApp').controller('SomeController', function($scope, $element, $attrs, $transclude) {
// 控制器逻辑放在这里
});
2）、匿名函数
也可以直接在指令内部的定义为匿名函数，同样我们可以再这里注入任何服务（$log,$timeout等等）
[javascript] view
plain copy
angular.module('myApp',[]) .directive('myDirective', function() {
restrict: 'A',
controller: function($scope, $element, $attrs, $transclude) {
// 控制器逻辑放在这里
}
});
另外还有一些特殊的服务（参数）可以注入
（a）$scope，与指令元素相关联的作用域
（b）$element，当前指令对应的元素
（c）$attrs，由当前元素的属性组成的对象
（d）$transclude，嵌入链接函数，实际被执行用来克隆元素和操作DOM的函数
注意： 除非是用来定义一些可复用的行为，一般不推荐在这使用。
指令的控制器和link函数可以进行互换。区别在于，控制器主要是用来提供可在指令间复用的行为但link链接函数只能在当前内部指令中定义行为，且无法再指令间复用。
下面是实例js中包含controller的一部分：定义了三个公共方法，供外部指令访问。
[javascript] view
plain copy
var myModule = angular.module("MyModule", []);
myModule.directive("superman", function() {
return {
scope: {},
restrict: 'AE',
controller: function($scope) {
$scope.abilities = [];
this.addStrength = function() {
$scope.abilities.push("strength");
};
this.addSpeed = function() {
$scope.abilities.push("speed");
};
this.addLight = function() {
$scope.abilities.push("light");
};
},
link: function(scope, element, attrs) {
element.addClass('btn btn-primary');
element.bind("mouseenter", function() {
console.log(scope.abilities);
});
}
}
});
（2）、require
require当前标识符需要另一个标识符提供正确的函数功能。require的值可以是字符串或者数组。字符串代表另一个指令的名字，它将会作为link函数的第四个参数。controller的用法分为两种情形，一种是require自定义的controller，由于自定义controller中的属性方法都由自己编写，使用起来比较简单；另一种方法则是require angularjs内建的指令，其中大部分时间需要require的都是ngModel这个指令。
下面是实例程序：假设现在我们要编写三个指令，三个指令中的link链接函数中存在有很多重合的方法，这时候我们就可以将这些重复的方法写在一个指令的controller中。然后在这三个指令中，require这个拥有controller字段的的指令，最后通过link链接函数的第四个参数就可以引用这些重合的方法了。
[html] view
plain copy
<!doctype html>
<html ng-app="MyModule">
<head>
<meta charset="utf-8">
<link rel="stylesheet" href="css/bootstrap-3.0.0/css/bootstrap.css">
<script src="js/angular.min.js"></script>
</head>
<body>
<div class="row">
<div class="col-md-3">
<superman strength>动感超人---力量</superman>
</div>
</div><br>
<div class="row">
<div class="col-md-3">
<superman strength speed>动感超人2---力量+敏捷</superman>
</div>
</div><br>
<div class="row">
<div class="col-md-3">
<superman strength speed light>动感超人3---力量+敏捷+发光</superman>
</div>
</div>
</body>
<script type="text/javascript">
var myModule = angular.module("MyModule", []);
myModule.directive("superman", function() {
return {
scope: {},
restrict: 'AE',
controller: function($scope) {
$scope.abilities = [];
this.addStrength = function() {
$scope.abilities.push("strength");
};
this.addSpeed = function() {
$scope.abilities.push("speed");
};
this.addLight = function() {
$scope.abilities.push("light");
};
},
link: function(scope, element, attrs) {
element.addClass('btn btn-primary');
element.bind("mouseenter", function() {
console.log(scope.abilities);
});
}
}
});
myModule.directive("strength", function() {
return {
require: '^superman',
link: function(scope, element, attrs, supermanCtrl) {
supermanCtrl.addStrength();
}
}
});
myModule.directive("speed", function() {
return {
require: '^superman',
link: function(scope, element, attrs, supermanCtrl) {
supermanCtrl.addSpeed();
}
}
});
myModule.directive("light", function() {
return {
require: '^superman',
link: function(scope, element, attrs, supermanCtrl) {
supermanCtrl.addLight();
}
}
});
</script>
</html>
另外我们可以在require的参数值加上下面的某个前缀，这会改变查找控制器的行为：
（1）没有前缀，指令会在自身提供的控制器中进行查找，如果找不到任何控制器，则会抛出一个error
（2）？如果在当前的指令没有找到所需的控制器，则会将null传给link连接函数的第四个参数
（3）^如果在当前的指令没有找到所需的控制器，则会查找父元素的控制器
（4）?^组合
引用内置指令
[javascript] view
plain copy
angular.module('myApp')
.directive('spoint', function() {
return {
require: 'ngModel',
link: function(scope, elm, attrs, ctrl) {
ctrl.$parsers.unshift(function(viewValue) {
if (fibonacci.indexOf(parseInt(viewValue)) >= 0) {
ctrl.$setValidity('fibonacci', true);
return viewValue;
} else {
ctrl.$setValidity('fibonacci', false);
return undefined;
}
});
}
};
});
这里值得注意的是directive里link方法的第四个参数，我们在require里定义了ngModel 所以这里它是一个NgModelController，NgModelController是用来为ng-model提供了一组API。
9、scope
scope为这个标识符创建一个新的作用域，而不是继承符作用域。
（1）、scope的值分别为：false，true，{}
[html] view
plain copy
<!doctype html>
<html ng-app="MyModule">
<head>
<meta charset="utf-8">
<link rel="stylesheet" href="css/bootstrap-3.0.0/css/bootstrap.css">
</head>
<body>
<div ng-controller='MyCtrl' style="margin-left: 10px;border: solid 2px greenyellow;padding: 10px;width:400px;">
Ctrl:<br />
<input ng-model="userName" />{{userName}}<br />
Directive:<br />
<hello></hello>
<hello></hello>
</div>
</body>
<script src="js/angular.min.js"></script>
<script type="text/javascript">
var myModule = angular.module("MyModule", []);
myModule.controller("MyCtrl",function($scope){
$scope.userName="山水子农";
})
myModule.directive("hello", function() {
return {
restrict: 'AE',
scope:false,//ture or {}
template: '<div><input type="text" ng-model="userName"/>{{userName}}</div>',
replace: true
}
});
</script>
</html>
当scope为false时：Directive继承Ctrl的值，改变Ctrl的值，Directive的值也随之变化，反之亦如此。（继承不隔离）
当scope为true时：Directive继承Ctrl的值，改变Ctrl的值，Directive的值随之变化，但是改变Directive的值，Ctrl的值不变，兄弟Directive的值也不会变。（继承隔离）
当scope的值为{}时：没有继承Ctrl的值，所以Directive的值为空，改变任何一方的值均不能影响另一方的值。（不继承隔离）
（2）、scope的绑定策略
方法1：使用@（@attr）来进行单向文本（字符串）绑定
[html] view
plain copy
<!doctype html>
<html ng-app="MyModule">
<head>
<meta charset="utf-8">
<link rel="stylesheet" href="css/bootstrap-3.0.0/css/bootstrap.css">
</head>
<body>
<div ng-controller="MyCtrl">
<drink flavor="{{ctrlFlavor}}"></drink>
</div>
</body>
<script src="js/angular.min.js"></script>
<script type="text/javascript">
var myModule = angular.module("MyModule", []);
myModule.controller('MyCtrl', ['$scope', function($scope){
$scope.ctrlFlavor="AngularJs";
}])
myModule.directive("drink", function() {
return {
restrict:'AE',
template:"<div>{{flavor}}</div>",
link:function(scope,element,attrs){
scope.flavor=attrs.flavor;
}
}
});
</script>
</html>
上面的实例可以使用scope为flavor:'@'来代替link函数，注意@传递的是字符串不是对象。
[html] view
plain copy
<!doctype html>
<html ng-app="MyModule">
<head>
<meta charset="utf-8">
<link rel="stylesheet" href="css/bootstrap-3.0.0/css/bootstrap.css">
</head>
<body>
<div ng-controller="MyCtrl">
<drink flavor="{{ctrlFlavor}}"></drink>
</div>
</body>
<script src="js/angular.min.js"></script>
<script type="text/javascript">
var myModule = angular.module("MyModule", []);
myModule.controller('MyCtrl', ['$scope', function($scope){
$scope.ctrlFlavor="AngularJs";
}])
myModule.directive("drink", function() {
return {
restrict:'AE',
scope:{
flavor:'@'
},
template:"<div>{{flavor}}</div>"
}
});
</script>
</html>
方法二：使用=（=attr）进行双向绑定
[javascript] view
plain copy
<!doctype html>
<html ng-app="MyModule">
<head>
<meta charset="utf-8">
<link rel="stylesheet" href="css/bootstrap-3.0.0/css/bootstrap.css">
</head>
<body>
<div ng-controller="MyCtrl" style="margin-left: 10px;border: solid 2px greenyellow;padding: 10px;width:200px;">
Ctrl:
<br>
<input type="text" ng-model="ctrlFlavor">
<br>
Directive:
<br>
<drink flavor="ctrlFlavor"></drink>
</div>
</body>
<script src="js/angular.min.js"></script>
<script type="text/javascript">
var myModule = angular.module("MyModule", []);
myModule.controller('MyCtrl', ['$scope', function($scope){
$scope.ctrlFlavor="AngularJs";
}])
myModule.directive("drink", function() {
return {
restrict:'AE',
scope:{
flavor:'='
},
template:'<input type="text" ng-model="flavor"/>'
}
});
</script>
</html>
方法三：使用&来调用父作用域中的函数
可以利用前面的link函数取属性的方式来进行绑定，这里更方便的绑定方式就是利用&。
[html] view
plain copy
<!doctype html>
<html ng-app="MyModule">
<head>
<meta charset="utf-8">
<link rel="stylesheet" href="css/bootstrap-3.0.0/css/bootstrap.css">
</head>
<body>
<div ng-controller="MyCtrl">
<greeting greet="sayHello(name)"></greeting><br/>
<greeting greet="sayHello(name)"></greeting><br/>
<greeting greet="sayHello(name)"></greeting><br/>
</div>
</body>
<script src="js/angular.min.js"></script>
<script type="text/javascript">
var myModule = angular.module("MyModule", []);
myModule.controller('MyCtrl', ['$scope', function($scope){
$scope.sayHello=function(name){
alert("Hello "+name);
}
}])
myModule.directive("greeting", function() {
return {
restrict:'AE',
scope:{
greet:'&'
},
template:'<input type="text" ng-model="userName" /><br/>'+
'<button class="btn btn-default" ng-click="greet({name:userName})">Greeting</button><br/>'
}
});
</script>
</html>
内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 
相关文章推荐
- AngularJs自定义指令详解（5） - link
- AngularJs自定义指令详解（5） - link
- AngularJs自定义指令详解（2） - template
- AngularJs自定义指令详解（2） - template
- 菜鸟学习-C语言函数参数传递详解-结构体与数组 分类： C/C++ Nginx 2015-07-14 10:24 89人阅读 评论(0) 收藏
- 数据库阿里连接池 druid配置详解 标签： druidspringjavaxml配置阿里池 2016-06-16 00:34 57532人阅读 评论(11) 收藏 举报 版权声明：本文为博主原创文
- AngularJS指令参数详解
- Spring @Transactional （一） 加强版 标签： springexception数据库jdbcjavahibernate 2010-10-21 17:54 38545人阅读 评论(
- AngularJs自定义指令详解（7） - multiElement
- Zedboard学习（三）：PL下流水灯实验 标签： fpgazynqPL 2017-07-05 11:09 21人阅读 评论(0)
- 详解AngularJS中自定义指令的使用
- angular 自定义指令参数详解
- python参数 分类： python基础学习 python 2013-08-23 15:06 217人阅读 评论(0) 收藏
- Angularjs使用directive自定义指令实现attribute继承的方法详解
- Xcode other link flag参数详解和解决静态库冲突分析
- expected `;' before ‘iter’ 标签： iterator编译器compilerubuntuosgcc 2010-12-08 20:13 1927人阅读 评论(0) 收藏 举报
- angularJS自定义指令详解
- JAVA环境变量JAVA_HOME、CLASSPATH、PATH设置详解ZZ 分类： Android安装及配置 2015-01-15 19:39 59人阅读 评论(0) 收藏
- 骨骼动画详解－Spine 分类： Cocos2d－x 2015-02-07 13:47 209人阅读 评论(0) 收藏
- sorted（）排序详解 分类： python基础学习 python Module 2013-09-04 17:18 1372人阅读 评论(0) 收藏