在使用form.FormController和ngModel.NgModelController之前,先来学习一下怎么一个ng-model-options指令,觉得怎么这个指令挺好用的,我们知道ng-model是可以实现数据的双向绑定,至于双向数据绑定这个概念时必须要清楚的,都是这样的一个过程,view->scope和scope->view,只要双向绑定的element都是走怎么一个过程的,那么这个ng-model-options,就是可以实现对延迟更新、如何触发更新、时区(timezone针对input[type='date']等)等的控制,来看一下官网(http://t.cn/RUbL4rP这个不是,哈哈)的例子:
//github上的block-example/表单操作-11/ng-model-options.html
angular.module('optionsExample', []) .controller('ExampleController', ['$scope', function($scope) { $scope.user = { name: 'say', data: '' }; $scope.cancel = function(e) { if (e.keyCode == 27) { $scope.userForm.userName.$rollbackViewValue(); } }; }]);
<div ng-controller="ExampleController"> <form name="userForm"> Name: <input type="text" name="userName" ng-model="user.name" ng-model-options="{ updateOn: 'blur',debounce: 1000 ,getterSetter: false }" ng-keyup="cancel($event)" /><br /> Other data: <input type="text" ng-model="user.data" /><br /> </form> <pre>user.name = <span ng-bind="user.name"></span></pre> </div>
updateOn:可以写入事件名字,将此element按所写事件触发更新
debounce:当我们写进keydowm事件的时候,我需要的是它尽可能说是当我输入完毕后,再去触发更新,那么这个时候我们可以延迟个1s!
getterSetter:为true的时候,则是指element的值是从函数return过来滴!
我们看一下这里, $scope.userForm.userName.$rollbackViewValue(); userForm、userName是什么鬼?眼尖的可以看到是表单的name和input[name='userName'],那么其实可以怎么理解表单实例可以随意地使用name属性暴露到scope中,于是在$scope就可以使用表单实例了,便可以使用表单控制器的属性和方法了!
form.FormController是啥?
FormController跟踪所有input和form的各种状态的控制,如被有效/无效/已交互/未交互。官网文档:http://docs.angularjs.cn/api/ng/type/form.FormController
其拥有的方法:
$rollbackViewValue(); $commitViewValue(); $addControl(); $removeControl(); $setValidity(); $setDirty(); $setPristine(); $setUntouched(); $setSubmitted();
$addControl() //添加ngModel controller ,ngModel会自动添加,除非自定义指令或许会用上
$removeControl() //与$addControl()相反
$setValidity() //在自定义表单检验有着很大作用
$rollbackViewValue() //这个我是这样理解的,回滚到上一个ViewValue
拥有的属性:
$pristine(form没被动过) $dirty(form被动过) $valid(全部验证通过) $invalid(验证不通过) $submitted
$error
email、max、maxlength、min、minlength、number、pattern、required、url、date、datetimelocal、time、week、month
给一个官网的例子(使用表单控制器的属性和方法怎么去验证input的正确性):
//github上的block-example/表单操作-11/ng-form.html,其它类型的input[type=*]验证也都更新到github了
<!doctype html> <html ng-app='formExample'> <head> <meta charset="utf8"/> <script src="http://code.angularjs.org/angular-1.0.1.min.js"></script> <style> .my-form { -webkit-transition:all linear 0.5s; transition:all linear 0.5s; background: transparent; } .my-form.ng-invalid { background: red; } </style> <script> angular.module('formExample', []) .controller('FormController', ['$scope', function($scope) { $scope.userType = 'guest'; $scope.email = '739288994@qq.com'; var list = $scope.list = []; $scope.submit = function() { if($scope.userType){ list.push(this.userType);} if($scope.email){ list.push(this.email);} // console.log(this.userType+","+this.email); // console.log($scope.list); }; }]); </script> </head> <body> <!--表单控制器--> <form name="myForm" ng-submit="submit()" ng-controller="FormController" class="my-form" > userType: <input name="input" type="text" ng-model="userType" required> <span class="error" ng-show="myForm.input.$error.required">Required!</span><br> <!--这里的意思是没有填的话就会显示--> email: <input name="email" type="email" ng-model="email"> <span class="error" ng-show="myForm.email.$error.email">Wrong Email!</span> <br> <input type="submit" value="提交" id="submit" /> <tt>userType = {{userType}}</tt><br> <tt>email = {{email}}</tt><br> <tt>myForm.input.$valid = {{myForm.input.$valid}}</tt><br> <!--表单的input的有效为true--> <tt>myForm.input.$error = {{myForm.input.$error}}</tt><br> <!--表单的input的$error--> <tt>myForm.email.$valid = {{myForm.email.$valid}}</tt><br> <!--表单的input的有效为true--> <tt>myForm.email.$error = {{myForm.email.$error}}</tt><br> <!--表单的input的$error--> <tt>myForm.$error.email = {{!!myForm.$error.email}}</tt><br> <tt>myForm.$error.required = {{!!myForm.$error.required}}</tt><br> <!--$error属性的required--> <tt>myForm.$valid = {{myForm.$valid}}</tt><br> <!--有效效为true--> <tt>myForm.$invalid = {{myForm.$invalid}}</tt><br> <!--无效为true--> <tt>myForm.$pristine= {{myForm.$pristine}}</tt><br> <!--与表单有相互作用为true--> <tt>myForm.$dirty= {{myForm.$dirty}}</tt><br> <!--与表单无相互作用为true--> <tt>myForm.$submitted = {{myForm.$submitted}}</tt><br> <tt>提交的数据:{{list|json}}</tt> </form> </body> </html> <!-- If the name attribute is specified, the form controller is published onto the current scope under this name. --> <!--表单阻止了表单默认action提交的方式,改用ng-submit或ng-click对表单进行绑定,具体操作看列子--> <!-- <form [name=""]>...</form> 等价于 <div ng-form='##'></div> 控制器为name属性的值 -->
具体可以看代码!
ngModel.NgModelController是啥?
NgModelController 为ngModel指令提供了API。该控制器包含数据双向绑定服务、验证、Value格式化和解析、CSS更新。它不包含任何逻辑处理DOM渲染或DOM event,这样的DOM相关逻辑应使用其他指令,NgModelController用来控制元素的数据绑定。Angular默认提供许多关于input元素 DOM逻辑处理。官网文档:http://docs.angularjs.cn/api/ng/type/ngModel.NgModelController
其拥有的方法:
$render(); $isEmpty(value); $setValidity(validationErrorKey, isValid); $setPristine(); $setDirty(); $setUntouched(); $setTouched(); $rollbackViewValue(); $validate(); $commitViewValue(); $setViewValue(value, trigger);
$render: angular 会把 $modelValue 经过 $formatters 得出来的值放入 $viewValue中,(这时 $viewValue = $modelValue 经过 $formatters) 然后触发我们写好的 $render . 跟着$setViewValue(value, trigger);一起使用。
$setViewValue:scope改变$modelValue,使用$setViewValue(),改变$viewValue
$setValidity:使用这个配合$parsers可以实现表单自定义验证
拥有的属性:
$viewValue //界面显示的数据
$modelValue //$scope上面的value
$parsers //在view->model的时候会触发的一个函数组,无论什么时候Model发生改变,所有的ngModelController.$formatters(model发生改变时触发数据有效验证和格式化转变)数组中的function将排队执行,所以在这里每一个function都有机会去格式化model的值,并且通过NgModelController.$setValidity修改空间的验证状态。
$formatters //在model->view的时候会触发的一个函数组, 无论任何时候用户与控件发生交互,将会触发NgModelCtroller.$setViewValue。这时候轮到执行NgModelController.$parsers(当控件从dom取值之后,将会执行这个数组中的所有方法,对值进行审查过滤或转换,也进行验证)数组中的所有方法。
$validators
$asyncValidators
$viewChangeListeners
$error
$pending
$untouched
$touched
$pristine
$dirty
$valid
$invalid
$name
那么多个属性都差不多,是不是关系很密切勒!双向绑定的机制可以在$parsers和$formatters可以体现出来,通过这些我们可以在view->scope做类似表单验证(自定义)的功能(配合$setValidity(validationErrorKey, isValid);),scope->view数据格式自定义等操作(配合$setViewValue(value, trigger);),可以看一下下面的这个例子(https://github.com/xiaobin5201314/AngularJS-Learning/blob/master/block-example/表单操作-11/ng-model.html):
var custom = angular.module('customControl', ['ngSanitize']);
custom.directive("noxiaobin", function () {
return {
restrict: "A",
require: "?ngModel",
link: function (scope, element, attrs, ngModel) {
if (!ngModel) return;
ngModel.$parsers.push(function (v) { //传说中的验证器
if (v != "xiaobin") {
ngModel.$setValidity('noxiaobin', true); //通过获取从dom过来的值,然后进行验证,使用$setValidity('noxiaobin', true);改变noxiaobin的值,然后反馈会dom
return v;
} else {
ngModel.$setValidity('noxiaobin', false);
return undefined;
}
});
}
}
});
custom.directive('contenteditable', ['$sce', function($sce) {
return {
restrict: 'A', //指定该指令是为属性类型的指令
require: '?ngModel', // 与ngModel指令的相互交流
link: function(scope, element, attrs, ngModel) { //scope分别是指令作用的作用域,element触发指令的元素,attrs是element的属性集合,ngmodel是控制器就是引入的ngModel
if (!ngModel) return;
// output data to the view
ngModel.$render = function() {
element.html($sce.getTrustedHtml(ngModel.$viewValue || '')); //$viewValue的值进行format
};
//对element的监听
element.on('blur keyup change', function() {
scope.$evalAsync(read); //执行read方法
});
read(); // 初始化
// Write data to the model
function read() {
var html = element.html();
// When we clear the content editable the browser leaves a <br> behind
// If strip-br attribute is provided then we strip this out
if ( attrs.stripBr && html == '<br>' ) {
html = '';
}
ngModel.$setViewValue(html); //获取ViewValue,设置$viewValue
}
}
};
}]);
<form name="myForm"> <div contenteditable name="myWidget" ng-model="userContent" strip-br="true" required>点击编辑</div> <span ng-show="myForm.myWidget.$error.required">Required!</span> <input type="text" name="email" ng-model="email" noxiaobin /> <span ng-show="myForm.email.$error.noxiaobin">Value nerver have xiaobin!</span> <hr> <textarea ng-model="userContent"></textarea> </form>
以上有两个指令分别是
1、view->scope,配合$setValidity(validationErrorKey, isValid);进行表单验证,通过反馈回view的noxiaobin来判断是否显示
2、scope->view,使用$setViewValue(value, trigger);设置view的值,然后触发$render,对其进行格式化
3、代码下载:https://github.com/xiaobin5201314/AngularJS-Learning
对于ngModel.NgModelController确实有些绕,也有些地方还是不懂,不过也有些文章写得还是比较明晰的,如:http://sentsin.com/web/659.html,如果对ngModel.NgModelController有那些更加全,或是更加详细的资料可以拿给我学习学习!!!