AngularJS自带了对表单或控件的输入数据进行验证的功能,对于Html5的基础控件均有内建的验证器,以下列举了所有支持的验证类型:
- max
- maxlength
- min
- minlength
- number
- pattern
- required
- url
- date
- datetimelocal
- time
- week
- month
AngularJS会在元素上自动添加如下样式:
ng-valid
: 验证通过ng-invalid
: 验证失败ng-valid-[key]
: 由$setValidity添加的所有验证通过的值ng-invalid-[key]
: 由$setValidity添加的所有验证失败的值ng-pristine
: 控件为初始状态ng-dirty
: 控件输入值已变更ng-touched
: 控件已失去焦点ng-untouched
: 控件未失去焦点ng-pending
: 任何为满足$asyncValidators的情况
示例1:
1 3 4 17 18 19 33 34 3573
74
82
示例1中,首先对form添加novalidate属性来禁用form的浏览器默认验证行为:
对必填的控件添加required属性:
本例有2种验证结果展示方式:
1. 控件边框颜色变化:
本文开头已说过,AngularJS会在验证控件后自动添加内建的样式名称,因此,我们只需对这些预定义的样式名称添加实际的样式代码即可:
1 .ng-invalid.ng-dirty { 2 border-color: #FA787E; 3 } 4 5 .ng-valid.ng-dirty { 6 border-color: #78FA89; 7 } 8 9 .ng-pristine.ng-pristine {10 border-color: #ffd800;11 }
2. 文字显示验证失败原因(以name控件为例):
Name is required.
ng-hide:当name为初始化状态或者通过验证的状态,无需显示错误信息提示;
ng-show:当name控件验证失败时,展示错误提示信息。
AngularJS还提供了一些内建的状态值,方便我们直接使用:
- $dirty:内容已变更
- $pristine:初始化状态
- $valid:验证通过
- $invalid:验证失败
- $submitted:已提交
- $error:所有验证失败的hash对象
- $$success:所有验证通过的hash对象
- $pending:所有pending(异步验证)的hash对象
form中添加ng-submit属性,并且当myForm.$valid(即myForm中包含的所有验证均通过时,该值才为true)提交表单并调用addStudent方法:
这样,当在页面上填写完有效的信息后,我们就可以将学生对象添加到Controller的students中,并由于双向绑定的特性,最终将提交的信息同步展示到页面上。
自定义验证器
你可能也猜到了,AngularJS也为我们准备好了自定义验证的方式。AngularJS实际上是通过自定义Directive,并在link中将验证方法添加到指定控件的$validators中, 在$validators中定义的对象必须有modelValue和viewValue两个参数,AngluarJS会在底层调用$setValidity来验证它。
我们看一个简单的例子,自定义验证Directive:myInteger(my-integer),输入值必须是以“1”开头,并为3位数字。
示例2:
1 3 4 5 31 32 3337 38
修改AngularJS的内建验证器方法
当然如果你需要重写AngularJS内建的验证也是可以的。
示例3(官方Demo):
1 3 4 5 28 29 3038 39
在创建Directive:overwriteEmail并定义它的行为时,首先判断是否当前控件存在,且控件上已定义了email这个验证器,若存在则改写其验证。
本例中,改写后的email验证,将使以@example.com为后缀的email地址才能通过验证。
本篇讲述了AngularJS的控件验证方式以及自定义验证器,学会了使用验证器,我们就可以控制页面输入数据的合法性了,这样,我们的页面逻辑就更加完善了。
参考资料
AngularJS官方文档:
CodeSchool快速入门视频: