在运用angularjs的时候,运用自定义指令可以写一些组件,非常方便。这里给大家分享一些关于angular自定义指令的知识。
1. 定义
对于指令,可以把它简单的理解成在特定DOM元素上运行的函数,指令可以扩展这个元素 的功能。
2.定义指令的方法:
angular.module('myApp',[])
.directive('myDirective',function ($timeout,UserDefinedService) {
// 指令定义放在这里
});
第一个参数,指令的名字myDirective 用来在视图中引用特定的指令。 第二个参数是一个函数,这个函数返回一个对象,$compile服务利用这个方法返回的对 象,在DOM调用指令时来构造指令的行为。
3.指令设置的选项
angular.module('myApp',function() {
return {
restrict: String,priority: Number,terminal: Boolean,template: String or Template Function:
function(tElement,tAttrs) (...},templateUrl: String,replace: Boolean or String,scope: Boolean or Object,transclude: Boolean,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,iAttrs,controller) { ... },post: function(scope,controller) { ... }
}
// 或者
return function postLink(...) { ... }
}
}; });
-
restrict 指令在DOM中可以何种形式被引用或声明 可选值如下: ( 可组合使用 ) E(元素) <my-directive></my-directive> A(属性,默认值) <div my-directive="expression"></div> C(类名) <div class="my-directive:expression;"></div> M(注释) <--directive:my-directive expression-->
priority 优先级 用来表示指令使用的优先顺序 如果一个元素上具有两个优先级相同的指令,声明在前面的那个会被优先调用。如果其中一 个的优先级更高,则不管声明的顺序如何都会被优先调用:具有更高优先级的指令总是优先运行。
-
terminal 用来告诉AngularJS停止运行当前元素上比本指令优先级低的指令。但同当前指令 优先级相同的指令还是会被执行。 <div ng-app="myApp" ng-controller="myCtr">
<!--此处在div上使用了两个自定义指令,作为属性存在,但directiveOne优先级高,而且设置了terminal属性,所以directiveSec指令并不会执行-->
<div directive-Sec directive-One>
这是自定义指令
</div>
</div>
var myCtr=["$scope",function($scope){}]
var app=angular.module("myApp",[]);
app.controller("myCtr",myCtr);
app.directive("directiveOne",function(){
return {
restrict: "ECMA",priority: 2,terminal: true,template:function(tElement,tAttrs){
tElement[0].style.fontSize="18px"; //设置字体
}
}
});
app.directive("directiveSec",priority: 1,tAttrs){
tElement[0].style.color="red"; //设置颜色
}
}
});
-
template 用来表示模板,可以是一段字符串,如“<h1>这是自定义指令</h2>”,也可以是一个函数,可以参考上面的例子 template:function(tElement,tAttrs){
//tElement表示当前元素,是一个数组,tAttrs表示该元素的属性,是一个对象
tElement[0].style.color="red"; //设置颜色
}
templateUrl 用来表示模板,与上面的template功能相似,但表示路径,可以是外部HTML文件路径的字符串也可以是一个可以接受两个参数的函数,参数为tElement和tAttrs,并返回一个外部HTML文件 路径的字符串。
-
replace 默认为false,模板会被当作子元素插入到调用此指令的元素内部,为true,则直接替换此元素 <div some-directive></div>
.directive('someDirective',function() {
return {
template: '<div>some stuff here<div>'
}; });
<!-- 调用指令之后的结果如下(这是默认replace为false时的情况): -->
<div some-directive>
<div>some stuff here<div>
</div>
<!-- 如果replace被设置为了true: -->
.directive('someDirective',function() {
return {
replace: true // 修饰过
template: '<div>some stuff here<div>'
}; });
<!-- 指令调用后的结果将是: -->
<div>some stuff here<div>
-
scope (1)当scope设置为true时,会从父作用域继承并创建一个新的作用域对象。
(2) 默认为false,并不会创建新的作用域对象,直接使用父scope。
(3)设置为{},表示隔离作用域,指令的 模板就无法访问外部作用域了 var myCtr=["$scope",function($scope){
$scope.name="father controller!!"
}]
var app=angular.module("myApp",function(){
return {
restrict:"ECMA",template: '<div>这是自定义指令{{name}}<div>',scope:{},controller:function($scope){
console.log($scope.name);//打印出来为undefined,因为无法访问尾部作用域了
}
}
}); 当然,AngularJS提供了几种方法能够将指令内部的隔离作用域,同指令外部的作用域进行数据绑定。
(a)@ (or @attr) 单向绑定,外部scope能够影响内部scope,但反过来不成立 <body>
<div ng-app="myApp" ng-controller="myCtr">
<input type="" name="" ng-model="value">
<!-- 注意此处的svalue要写成s-Value,不然没效果-->
<directive-One s-Value="{{value}}">
</directive-One>
</div>
<!-- -->
</body>
<script type="text/javascript">
var myCtr=["$scope",function($scope){
$scope.value="";
}]
var app=angular.module("myApp",[]);
app.controller("myCtr",myCtr);
app.directive("directiveOne",function(){
return {
restrict:"ECMA",template: '<div>这是自定义指令<input type="" name="" ng-model="sValue">{{sValue}}<div>',scope:{
sValue:"@"
},controller:function($scope){
$scope.sValue="";
console.log($scope.sValue);
}
}
});
</script> (b)= (or =attr) 双向绑定,外部scope和内部scope的model能够相互改变 <body>
<div ng-app="myApp" ng-controller="myCtr">
<input type="" name="" ng-model="value">
<!-- = 前面的value表示自定义指令自己的属性名,后面的value表示父作用域的value -->
<directive-One value="value">
</directive-One>
</div>
</body>
<script type="text/javascript">
var myCtr=["$scope",function($scope){
$scope.value="1";
}]
var app=angular.module("myApp",[]);
app.controller("myCtr",myCtr);
app.directive("directiveOne",function(){
return {
restrict:"ECMA",template: '<div>这是自定义指令<input type="" name="" ng-model="value">{{value}}<div>',scope:{
value:"="
},controller:function($scope){
$scope.value="";
console.log($scope.value);
}
}
});
</script> ![图片描述][1]
上面的输入框输入,下面会变,下面的输入框输入上面的也会变
(c)& (or &attr) 把内部scope的函数的返回值和外部scope的任何属性绑定起来
controller controller参数可以是一个字符串或一个函数。当设置为字符串时,会以字符串的值为名字, 来查找注册在应用中的控制器的构造函数.当为函数时,可以像平时写控制器那样写,可以将任意可以被注入的AngularJS服务传递给控制器
controllerAs(字符串) controllerAs参数用来设置控制器的别名,可以以此为名来发布控制器,并且作用域可以访 问controllerAs。这样就可以在视图中引用控制器,甚至无需注入$scope。
require require参数可以被设置为字符串或数组,字符串代表另外一个指令的名字。require会将控 制器注入到其值所指定的指令中,并作为当前指令的链接函数的第四个参数。
字符串或数组元素的值是会在当前指令的作用域中使用的指令名称。 (编辑:李大同)
【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容!
|