angular 指令 要点解析

时间:2024-12-11 16:03:20

指令可以删繁就简前端的js代码,杜绝重复的js代码和html代码。

下面就对指令的重要属性进行罗列

一、restrict  定义指令的出现形式

   可以定义为多种形式,比如 restrict = 'AE' 标识可以是属性,也可以是元素。restrict  =  'AECM' 则标识支持下面所有形式

  • Attribute 属性: <div my-directive=”exp”></div>
  • Element 元素: <my-directive></my-directive>
  • Class : <div class=”my-directive:exp;”></div>
  • M 注释:<!-- directive: my-directive exp -->

 鉴于浏览器兼容问题。推荐 restrict  =  'A'

二、scope 作用域,与值绑定

  scope  = true/false/{name:'=/@/&'}   

  默认为false,如果设置为true 则说明指令内部独立作用域。

  scope: {
   lover: '=',
   name: '@',
   say: '&'
  }

  1、{name:'@inputName'} name 指 指令中作用域中scope.name , inputName 可不写。默认绑定属性name。eg:<directive inputName="小明-{{data.class}}">

  

  2、= 双向绑定比较常用

  如:<lover="绑定内容"> 绑定内容可以理解为指令外部scope环境中的所有。它已经不是字符串的意义。甚至比如一个function的引用。 lover="sayChange" 那么love()就执行scope.sayChange(),如果scope.sayChange是对象、那么lover改变与sayChange改变均会联动修改关联的对方。

  3、”&“:绑定 Contoller中对应$scope上的函数。

 

三、template/templateUrl

  模板,该指令内部会被改html所代替, 如果设置了replace =true ,则outerHtml也会被移除。(会影响改标签后面的其他指令)

四、combine编译阶段 提供两个参数element,attrs。

  可以对当前元素做一些操作。返回link方法或者什么prelink等等。细节不说了。感觉用的也不多。 此处存在一个小bug 这个阶段给element添加进去的html包含{{}} 到后面不会执行。但是加上 template=“”,就可以解决

五、link 参数为 scope ,element,attrs ,ctrl  ( ctrl 当  require = ngController才会有)

  如果有combine,link需要作为combine的return 对象。

  link require="ngModel",则可以拿到ngModelController,那么Ctrl就可以有很多的扩展点,这也是我要写本文的目的所在。其他事不过走走过场而已。

  ngModel对于值有两个重要的概念叫modelValue,和viewValue  见名知意,我们可以理解为数据库持久化值为ModelValue而最终展示到UI上给用户看到的是viewValue。他们可以不同。

  1、ctrl.$formatters 格式化链 ngModel 的 ModelValue to ViewVlaue过程中需要有序执行的一串 function,

    那就太方便了。比如扩展格式化:日期、金额格式化;校验:假如modelValue不合法、则不会展示到前端。

  2、 ctrl.$parsers 解析链 ngModel 的 ViewValue to ModelValue过程中需要执行的一串function

    同样在 反格式化的处理:金额去除¥符号转为数字;校验不合法的数据无法提交给ModelView,(不提交给ModelValue 其他对改字段监控变化就不会得到通知。   angular双向绑定多么美妙的设计,)

  3、ctrl.$render 当视图需要更新时执行

    比如checkbox viewValue改成了false,render会将原生checkbox 的checked=true,可以重新赋值修改该function

最后提供几个例子可以感受formatters ,parsers ,强大的扩展性。

checkBox 数据库值为逗号分隔

 /**
* @ht-boolean 可为空, 格式以“/”分割truevalue 和falsevalue
* <span ht-boolean="Y/N" text="测试按钮" ng-model="prop.skipFirstNode" ht-tip title="我是按钮的提示"/>
*/
.directive('htBoolean', function() {
return {
restrict : 'A',
require:'ngModel',
scope : true,
link : function(scope, element, attrs,ctrl) {
var booleanConf =attrs.htBoolean;
scope.text = attrs.text;
if(booleanConf) booleanConf=booleanConf.split("/");
else booleanConf = [true,false]; var trueValue = booleanConf[0],falseValue = booleanConf[1]; ctrl.$formatters.push(function(value){
return value === trueValue;
}); ctrl.$parsers.push(function(value){
return value ? trueValue : falseValue;
}); ctrl.$render = function(){
scope.checked = ctrl.$viewValue;
}; element.on('click', function(){
scope.$apply(function() {
scope.checked = !scope.checked;
ctrl.$setViewValue(scope.checked);
});
});
},
template:'<lable class="btn label-sm {{checked ? \'active\':\'inactive\'}}" >{{text}}</lable>'
};
})

ht-boolean代替checkBox的自定义前端标签。(针对true、false两种状态的指令) 体验下$render的功能

 自定义表单校验 扩展平台自有校验

  

六、controller($scope,element)

  controller 先与combine执行。 

  

  

最后推荐有些异常情况无法解决的同仁直接查看源码,angular.js   @license AngularJS v1.2.19

 compileNodes 便是编译DOM元素的方法,里面applyDirectivesToNode 为实际处理指令的方法。 跟一下相信就清楚了。