在使用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有那些更加全,或是更加详细的资料可以拿给我学习学习!!!