AngularJS指令进阶 – ngModelController详解

2024-09-03 13:32

本文主要是介绍AngularJS指令进阶 – ngModelController详解,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

AngularJS指令进阶 – ngModelController详解

在自定义Angular指令时,其中有一个叫做require的字段,这个字段的作用是用于指令之间的相互交流。举个简单的例子,假如我们现在需要编写两个指令,在linking函数中有很多重合的方法,为了避免重复自己(著名的DRY原则),我们可以将这个重复的方法写在第三个指令的controller中,然后在另外两个需要的指令中require这个拥有controller字段的指令,最后通过linking函数的第四个参数就可以引用这些重合的方法。代码的结构大致如下:

var app = angular.modeule('myapp',[]);app.directive('common',function(){return {...controller: function($scope){this.method1 = function(){};this.method2 = function(){};},...}
});app.directive('d1',function(){return {...require: '?^common',link: function(scope,elem,attrs,common){scope.method1 = common.method1;..},...}
});app.directive('d2',function(){return {...require: '?^common',link: function(scope,elem,attrs,common){scope.method1 = common.method1;..},...}
});

当然,上面例子只是指令中controller用法的一种。虽然一般来说,使用controller字段的机会不是很多,但是想要写好AngularJS的指令,这是必须要掌握的一点。

显然,controller的用法分为两种情形,一种是require自定义的controller,由于自定义controller中的属性方法都由自己编写,使用起来比较简单;另一种方法则是require AngularJS内建的指令,其中大部分时间需要require的都是ngModel这个指令。很多时候,由于我们对ngModel中内建的方法和属性不熟悉,在阅读和编写代码时会有一些困难。今天我们的目的就是详细的介绍ngModel中的内建属性和方法,相信在认真的阅读完本文之后,你一定能够熟练的在指令中require ngModel。

在Angular应用中,ng-model指令时不可缺少的一个部分,它用来将视图绑定到数据,是双向绑定魔法中重要的一环。ngModelController则是ng-model指令中所定义的controller。这个controller包含了一些用于数据绑定,验证,CSS更新,以及数值格式化和解析的服务。它不用来进行DOM渲染或者监听DOM事件。与DOM相关的逻辑都应该包含在其他的指令中,然后让这些指令来试用ngModelController中的数据绑定功能。

下面,我们将用一个例子来说明如何在自定义指令中require ngModel。在这里例子中,我们使用HTML5中的contenteditable属性来制作了一个简单的编辑器指令,同时将在指令定义中require了ngModel来进行数据绑定。

HTML部分

<form name="myForm"><div contenteditablename="myWidget" ng-model="userContent"strip-br="true"required>Change me!</div><span ng-show="myForm.myWidget.$error.required">Required!</span><hr><textarea ng-model="userContent"></textarea>
</form>

指令定义部分

angular.module('customControl', []). directive('contenteditable', function() { return { restrict: 'A', // 作为元素属性 require: '?ngModel', // 获取ngModelController link: function(scope, element, attrs, ngModel) { if(!ngModel) return; // 如果没有ng-model则什么都不做

    // 指定UI的更新方式
    ngModel.$render = function() {element.html(ngModel.$viewValue || '');}; // 监听change事件来开启绑定
    element.on('blur keyup change', function() {scope.$apply(read);});read(); // 初始化
 // 将数据写入model
    function read() {var html = element.html(); // 当我们清空div时浏览器会留下一个<br>标签
      // 如果制定了strip-br属性,那么<br>标签会被清空
      if( attrs.stripBr && html == '<br>' ) {html = '';}ngModel.$setViewValue(html);}}
};

});

ngModelController方法

  • $render();

当视图需要更新的时候会被调用。使用ng-model的指令应该自行实现这个方法。

  • $isEmpty(value);

该方法用于判断输入值是否为空。 
例如,使用ngModelController的指令需要判断其中是否有输入值的时候会使用该方法。该方法可用来判断值是否为undefined,'',null或者NaN。 
你可以根据自己的需要重载该方法。

  • $setValidity(validationErrorKey, isValid);

该方法用于改变验证状态,以及在控制变化的验证标准时通知表格。 
这个方法应该由一个验证器来调用。例如,一个解析器或者格式化函数。

  • $setPristine();

该方法用于设置控制到原始状态。 
该方法可以移除'ng-dirty'类并将控制恢复到原始状态('ng-pristine'类)。

  • $cancelUpdate();

该方法用于取消一次更新并重置输入元素的值以防止$viewCalue发生更新,它会由一个pending debounced事件引发或者是因为input输入框要等待一些未来的事件。

如果你有一个使用了ng-model-options指令的输入框,并为它设置了debounced事件或者是类似于blur的事件,那么你可能会碰到在某一段时间内输入框中值和ngModel的$viewValue属性没有保持同步的情况。 
在这种情况下,如果你试着在debounced/future事件发生之前更新ngModel的$modelValue,你很有可能遇到困难,因为AngularJS的dirty cheching机制实际上并不会分辨一个模型究竟有没有发生变化。 
$cancelUpdate()方法应该在改变一个输入框的model之前被调用。记住,这很重要因为这能够确保输入字段能够被新的model值更新,而pending操作将会被取消。下面是一个例子:

HTML部分

 <form name="myForm" ng-model-options="{ updateOn: 'blur' }">
<p>With $cancelUpdate()</p>
<input name="myInput1" ng-model="myValue" ng-keydown="resetWithCancel($event)"><br/>
myValue: "{{ myValue }}"<p>Without $cancelUpdate()</p>
<input name="myInput2" ng-model="myValue" ng-keydown="resetWithoutCancel($event)"><br/>
myValue: "{{ myValue }}"</form>
</div>  

JS部分

angular.module('cancel-update-example', []).controller('CancelUpdateCtrl', function($scope) {$scope.resetWithCancel = function (e) {
if (e.keyCode == 27) {$scope.myForm.myInput1.$cancelUpdate();$scope.myValue = '';
}};$scope.resetWithoutCancel = function (e) {
if (e.keyCode == 27) {$scope.myValue = '';
}};
});  
  • $setViewValue(value, trigger)方法

    该方法用来更新视图值。这个方法应该在一个视图值发生变化时被调用,一般来说是在一个DOM事件处理函数中。例如,input和select指令就调用了这个函数。 
    这个方法将会更新$viewValue属性,然后在$pasers中通将这个值传递给每一个函数,其中包括了验证器。这个值从$parsers输出后,将会被用于$modelValue以及ng-model属性中的表达式。 
    最后,所有位于$viewChangeListeners列表中注册的监听器将会被调用。

ngModelController中的属性

  • $viewValue

    视图中的实际值

  • $modelValue

    model中的值,它金额控制器绑定在一起

  • $parsers

    将要执行的函数的数组,无论什么时候控制器从DOM中读取了一个值,它都将作为一个管道。其中的函数依次被调用,并将结果传递给下一个。最后出来的值将会被传递到model中。其中将包括验证和转换值的过程。对于验证步骤,这个解析器将会使用$setValidity方法,对于不合格的值将返回undefined。

  • $formatters

    一个包含即将执行函数的数组,无论什么时候model的值发生了变化,它都会作为一个管道。其中的每一个函数都被依次调用,并将结果传递给下一个函数。该函数用于将模型传递给视图的值进行格式化。

    • $viewChangeListeners

只要视图的值发生变化,其中的函数就会被执行。其中的函数执行并不带参数,它的返回值也会被忽略。它可以被用在额外的#watches中。

  • $error

一个包含所有error的对象

  • $pristine

如果用户还没有进行过交互,值是true。

  • $dirty

如果用户已经进行过交互,值是true。

  • $valid

如果没有错误,值是true。

  • $invalid

如果有错误,值是true。


本文参考自AngularJS文档,原文地址https://docs.angularjs.org/api/ng/type/ngModel.NgModelController

这篇关于AngularJS指令进阶 – ngModelController详解的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1133095

相关文章

springboot security快速使用示例详解

《springbootsecurity快速使用示例详解》:本文主要介绍springbootsecurity快速使用示例,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝... 目录创www.chinasem.cn建spring boot项目生成脚手架配置依赖接口示例代码项目结构启用s

Python中随机休眠技术原理与应用详解

《Python中随机休眠技术原理与应用详解》在编程中,让程序暂停执行特定时间是常见需求,当需要引入不确定性时,随机休眠就成为关键技巧,下面我们就来看看Python中随机休眠技术的具体实现与应用吧... 目录引言一、实现原理与基础方法1.1 核心函数解析1.2 基础实现模板1.3 整数版实现二、典型应用场景2

一文详解SpringBoot响应压缩功能的配置与优化

《一文详解SpringBoot响应压缩功能的配置与优化》SpringBoot的响应压缩功能基于智能协商机制,需同时满足很多条件,本文主要为大家详细介绍了SpringBoot响应压缩功能的配置与优化,需... 目录一、核心工作机制1.1 自动协商触发条件1.2 压缩处理流程二、配置方案详解2.1 基础YAML

Python实现无痛修改第三方库源码的方法详解

《Python实现无痛修改第三方库源码的方法详解》很多时候,我们下载的第三方库是不会有需求不满足的情况,但也有极少的情况,第三方库没有兼顾到需求,本文将介绍几个修改源码的操作,大家可以根据需求进行选择... 目录需求不符合模拟示例 1. 修改源文件2. 继承修改3. 猴子补丁4. 追踪局部变量需求不符合很

java中反射(Reflection)机制举例详解

《java中反射(Reflection)机制举例详解》Java中的反射机制是指Java程序在运行期间可以获取到一个对象的全部信息,:本文主要介绍java中反射(Reflection)机制的相关资料... 目录一、什么是反射?二、反射的用途三、获取Class对象四、Class类型的对象使用场景1五、Class

golang 日志log与logrus示例详解

《golang日志log与logrus示例详解》log是Go语言标准库中一个简单的日志库,本文给大家介绍golang日志log与logrus示例详解,感兴趣的朋友一起看看吧... 目录一、Go 标准库 log 详解1. 功能特点2. 常用函数3. 示例代码4. 优势和局限二、第三方库 logrus 详解1.

一文详解如何从零构建Spring Boot Starter并实现整合

《一文详解如何从零构建SpringBootStarter并实现整合》SpringBoot是一个开源的Java基础框架,用于创建独立、生产级的基于Spring框架的应用程序,:本文主要介绍如何从... 目录一、Spring Boot Starter的核心价值二、Starter项目创建全流程2.1 项目初始化(

Spring Boot3虚拟线程的使用步骤详解

《SpringBoot3虚拟线程的使用步骤详解》虚拟线程是Java19中引入的一个新特性,旨在通过简化线程管理来提升应用程序的并发性能,:本文主要介绍SpringBoot3虚拟线程的使用步骤,... 目录问题根源分析解决方案验证验证实验实验1:未启用keep-alive实验2:启用keep-alive扩展建

Java异常架构Exception(异常)详解

《Java异常架构Exception(异常)详解》:本文主要介绍Java异常架构Exception(异常),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录1. Exception 类的概述Exception的分类2. 受检异常(Checked Exception)

C#基础之委托详解(Delegate)

《C#基础之委托详解(Delegate)》:本文主要介绍C#基础之委托(Delegate),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录1. 委托定义2. 委托实例化3. 多播委托(Multicast Delegates)4. 委托的用途事件处理回调函数LINQ