AngularJs 表单字段合法性校验
基于AngularJS入门与进阶(江荣波 著)这本书的笔记
AngularJS 1.x的demo
AngularJS1.x和Angular2,4,5是不一样的两个东西,构建方式,语法,都很多不同
参考文章:https://www.oschina.net/translate/angularjs-form-validation
在AngularJs要使用自带的表单验证,只需要在页面定义一个<form>
标签,然后定义表单,再使用ng-model
进行数据的双向绑定就可以了。
CSS样式与状态对应的属性关系
CSS样式 | 状态属性 | 描述 |
---|---|---|
ng-valid | $valid | 表单输入合法 |
ng-invalid | $invalid | 表单输入不合法 |
ng-pristine | $pristine | 表单元素未被使用 |
ng-dirty | $dirty | 表单元素被使用 |
ng-touched | $touched | 元素获取焦点 |
ng-untouched | $untouched | 元素失去焦点 |
ng-empty | $empty | 元素内容为空 |
AngularJs表单常用校验相关属性和指令
校验名 | 指令名 | 示例 |
---|---|---|
必填 | required | <input type="text" required> |
最小长度 | ng-minlength="{number}" | <input type="text" ng-minlength="10"> |
最大长度 | ng-maxlength="{number}" | <input type="text" ng-maxlength="10"> |
正则匹配 | ng-pattern="/pattern/" | <input type="text" ng-pattern="[0-9]"> |
邮箱格式 | type = "email" | <input type="email" ng-model="user.email"> |
数字格式 | type = "number" | <input type="number" ng-model="user.age"> |
网址格式 | type = "url" | <input type="url" ng-model="user.url"> |
首先假设有个注册页面的场景,有个用户注册页面
- 用户名必填
- 密码只能是数字或者英文字母
- 密码长度8到16位
- 邮箱必须格式合法
ng-show
和ng-messages
指令
表单验证如果不通过,我们通常需要给用户提示出对应的错误信息,ng-show
指令可以在ng-show="false"
的时候控制显示和隐藏,true为显示,false为隐藏,上面表格也说了可以通过$invalid
获取到当前文本框是否合法的boolean
如果是单条错误提示可以用ng-show实现,有时候我们一个文本框有过多个验证,需要提示,可以用ng-messages指令,当检测到不合法的时候,会顺序显示第一条不合法的提示信息,如果需要使用ng-message指令,必须在module中引入ngMessages,并且页面引入angular-messages.js
一个简单控制器 app.js
var formApp = angular.module("formApp",["ngMessages"]);
formApp.controller("formController",function ($scope,$log) {
$scope.submitValid = function (isValid) {
if(!isValid) {
$('#showMsg').text("验证不通过,请检查!");
$('#showMsgDiv').modal();
}
}
});
demo页面 index.html
<!DOCTYPE html>
<html lang="en" ng-app="formApp">
<head>
<meta charset="UTF-8">
<title>表单验证</title>
<link rel="stylesheet" href="/bootstrap-3.3.7/dist/css/bootstrap.css">
<link rel="stylesheet" href="/bootstrap-3.3.7/dist/css/bootstrap-theme.min.css">
<script src="/lib/angular/angular.js"></script>
<script src="/lib/angular-messages/angular-messages.js"></script>
<script src="../../js/jquery-1.9.1/jquery.js"></script>
<script src="/bootstrap-3.3.7/dist/js/bootstrap.js"></script>
<script src="app.js"></script>
<style>
body
{ padding-top:30px;
padding-left: 600px;
}
</style>
</head>
<body ng-controller="formController">
<di class = 'page-header'><h3>AngularJs 表单验证</h3></di>
<!-- novalidate 禁用自带的验证规则-->
<form name ='userForm' novalidate ng-submit="submitValid(userForm.$valid)" style="width: 300px;">
<div class="form-group" style="height: 70px;">
<label>用户名</label>
<input type="text" class="form-control" name="userName" ng-model="userName" required>
<!--必填单纯判断会在页面加载的时候就显示错误提示,可以先判断表单是否未使用$pristine 可以避免页面加载进来就提示错误-->
<span ng-show="userForm.userName.$invalid && !userForm.userName.$pristine" class="help-block">必填项</span>
</div>
<div class="form-group" style="height: 70px;">
<label>密码</label>
<input type="text" class="form-control" name="password" ng-model="password"
ng-pattern="/^[A-Za-z0-9]+$/" ng-minlength="8" ng-maxlength="16">
<!--这里有2个验证规则,第一个是只能是数字或者字母,第二个是长度要在8-16位 使用ng-messages优先提示格式,然后提示长度-->
<div ng-messages="userForm.password.$error" >
<span ng-message="pattern">密码只能是数字或英文字母</span>
<span ng-message="minlength">密码长度最短8位</span>
<span ng-message="maxlength">密码长度最长16位</span>
</div>
</div>
<div class="form-group" style="height: 70px;">
<label>邮箱</label>
<input type="email" class="form-control" name="email" ng-model="email" >
<span ng-show="userForm.email.$invalid && !userForm.email.$pristine" class="help-block">邮箱格式错误</span>
</div>
<button type="submit" class="btn btn-primary">提交</button>
</form>
<!-- 模态弹出窗 -->
<div class="modal fade" id="showMsgDiv">
<div class="modal-dialog">
<div class="modal-content">
<div class="modal-header">
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
<h4 class="modal-title">提示信息</h4>
</div>
<div class="modal-body">
<p id="showMsg"></p>
</div>
<div class="modal-footer">
<button type="button" class="btn btn-default" data-dismiss="modal">关闭</button>
<!--<button type="button" class="btn btn-primary">保存</button>-->
</div>
</div><!-- /.modal-content -->
</div><!-- /.modal-dialog -->
</div><!-- /.modal -->
</body>
</html>

失去焦点时验证
从页面验证可以看出所有验证都是生效的了的,也按照我们的预期在验证,基于AngularJs的数据双向绑定,我们发现我们所有的验证都是及时生效的,这在大多数情况下是期望的,不过在注册这种情况下,我们不期望在用户输入的过程中就提示,期望是文本框失去焦点或者提交的时候验证。
ng-model-options
和 ng-blur
与ng-focus
如果要达到获取焦点或失去焦点的时候验证的方式比较多,这里举例两种,ng-model-options
和 ng-blur
与ng-focus
。
首先我们做了个变量change,在通过ng-blur
与ng-focus
在获取或失去焦点的时候改变这个值,让ng-show指令中的表达式在失去焦点的时候才成立往下验证
对像中的blur,给对象添加一个判断当前输入框是否失去焦点的属性 userForm.email.$error.blur
,再用input的事件ng-focus,ng-blur来动态改变这个值。
<div class="form-group" style="height: 70px;">
<label>邮箱</label>
<input type="email" class="form-control" name="email" ng-model="email"
ng-blur="change=true" ng-focus="change=false">
<span ng-show="change && userForm.email.$invalid && !userForm.email.$pristine" class="help-block">邮箱格式错误</span>
</div>
还可以用ng-model-option
,在默认情况下,任何内容的改变将触发表单验证和model的更新。ngModelOptions指令绑定到一个事件集合中来重写触发的时间,例如:ng-model-options="{ updateOn: 'blur' }" 将会在控件失去焦点后执行表单验证和更新Model。你可以使用空格来分割多个事件的触发验证和更新的时间。例如:ng-model-options="{ updateOn: 'mousedown blur' }"。
<div class="form-group" style="height: 70px;">
<label>密码</label>
<input type="text" class="form-control" name="password" ng-model="password"
ng-pattern="/^[A-Za-z0-9]+$/" ng-minlength="8" ng-maxlength="16"
ng-model-options="{ updateOn: 'blur' }">
<!--这里有2个验证规则,第一个是只能是数字或者字母,第二个是长度要在8-16位 使用ng-messages优先提示格式,然后提示长度-->
<div ng-messages="userForm.password.$error" >
<span ng-message="pattern" class="help-block">密码只能是数字或英文字母</span>
<span ng-message="minlength" class="help-block">密码长度最短8位</span>
<span ng-message="maxlength" class="help-block">密码长度最长16位</span>
</div>
</div>
ng-class
动态改变文本框样式
在验证的时候我们还期望错误的文本框改变颜色,ng-class
允许我们基于一个表达式添加类。因为我们使用了 Bootstrap, 我们将就使用它们提供的类(has-error)
<div class="form-group" style="height: 70px;" ng-class="{'has-error' : userForm.userName.$invalid && !userForm.userName.$pristine}">
<label>用户名</label>
<input type="text" class="form-control" name="userName" ng-model="userName" required
ng-model-options="{ updateOn: 'blur' }">
<!--必填单纯判断会在页面加载的时候就显示错误提示,可以先判断表单是否未使用$pristine 可以避免页面加载进来就提示错误-->
<span ng-show="userForm.userName.$invalid && !userForm.userName.$pristine" class="help-block">必填项</span>
</div>
<div class="form-group" style="height: 70px;" ng-class="{'has-error' : userForm.password.$invalid && !userForm.password.$pristine}">
<label>密码</label>
<input type="text" class="form-control" name="password" ng-model="password"
ng-pattern="/^[A-Za-z0-9]+$/" ng-minlength="8" ng-maxlength="16"
ng-model-options="{ updateOn: 'blur' }">
<!--这里有2个验证规则,第一个是只能是数字或者字母,第二个是长度要在8-16位 使用ng-messages优先提示格式,然后提示长度-->
<div ng-messages="userForm.password.$error" >
<span ng-message="pattern" class="help-block">密码只能是数字或英文字母</span>
<span ng-message="minlength" class="help-block">密码长度最短8位</span>
<span ng-message="maxlength" class="help-block">密码长度最长16位</span>
</div>
</div>
下面是完整的html,app.js没做改变
<!DOCTYPE html>
<html lang="en" ng-app="formApp">
<head>
<meta charset="UTF-8">
<title>表单验证</title>
<link rel="stylesheet" href="/bootstrap-3.3.7/dist/css/bootstrap.css">
<link rel="stylesheet" href="/bootstrap-3.3.7/dist/css/bootstrap-theme.min.css">
<script src="/lib/angular/angular.js"></script>
<script src="/lib/angular-messages/angular-messages.js"></script>
<script src="../../js/jquery-1.9.1/jquery.js"></script>
<script src="/bootstrap-3.3.7/dist/js/bootstrap.js"></script>
<script src="app.js"></script>
<style>
body
{ padding-top:30px;
padding-left: 600px;
}
</style>
</head>
<body ng-controller="formController">
<di class = 'page-header'><h3>AngularJs 表单验证</h3></di>
<!-- novalidate 禁用自带的验证规则-->
<form name ='userForm' novalidate ng-submit="submitValid(userForm.$valid)" style="width: 300px;">
<div class="form-group" style="height: 70px;" ng-class="{'has-error' : userForm.userName.$invalid && !userForm.userName.$pristine}">
<label>用户名</label>
<input type="text" class="form-control" name="userName" ng-model="userName" required
ng-model-options="{ updateOn: 'blur' }">
<!--必填单纯判断会在页面加载的时候就显示错误提示,可以先判断表单是否未使用$pristine 可以避免页面加载进来就提示错误-->
<span ng-show="userForm.userName.$invalid && !userForm.userName.$pristine" class="help-block">必填项</span>
</div>
<div class="form-group" style="height: 70px;" ng-class="{'has-error' : userForm.password.$invalid && !userForm.password.$pristine}">
<label>密码</label>
<input type="text" class="form-control" name="password" ng-model="password"
ng-pattern="/^[A-Za-z0-9]+$/" ng-minlength="8" ng-maxlength="16"
ng-model-options="{ updateOn: 'blur' }">
<!--这里有2个验证规则,第一个是只能是数字或者字母,第二个是长度要在8-16位 使用ng-messages优先提示格式,然后提示长度-->
<div ng-messages="userForm.password.$error" >
<span ng-message="pattern" class="help-block">密码只能是数字或英文字母</span>
<span ng-message="minlength" class="help-block">密码长度最短8位</span>
<span ng-message="maxlength" class="help-block">密码长度最长16位</span>
</div>
</div>
<div class="form-group" style="height: 70px;" ng-class="{'has-error' : change && userForm.email.$invalid && !userForm.email.$pristine}">
<label>邮箱</label>
<input type="email" class="form-control" name="email" ng-model="email"
ng-blur="change=true" ng-focus="change=false">
<span ng-show="change && userForm.email.$invalid && !userForm.email.$pristine" class="help-block">邮箱格式错误</span>
</div>
<button type="submit" class="btn btn-primary">提交</button>
</form>
<!-- 模态弹出窗 -->
<div class="modal fade" id="showMsgDiv">
<div class="modal-dialog">
<div class="modal-content">
<div class="modal-header">
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
<h4 class="modal-title">提示信息</h4>
</div>
<div class="modal-body">
<p id="showMsg"></p>
</div>
<div class="modal-footer">
<button type="button" class="btn btn-default" data-dismiss="modal">关闭</button>
<!--<button type="button" class="btn btn-primary">保存</button>-->
</div>
</div><!-- /.modal-content -->
</div><!-- /.modal-dialog -->
</div><!-- /.modal -->
</body>
</html>

提交时验证
提交时验证的原理也是通过angularJS的双向数据绑定原理,这里因为做了判断文本框是否使用,修改提交的验证方法,在提交的时候把所有文本框设置为已经使用,然后还做了个全局变量,是否提交,控制ng-show和ng-messages 判断表达式
app.js
var formApp = angular.module("formApp",["ngMessages"]);
formApp.controller("formController",function ($scope,$log) {
// 失去焦点验证变量
$scope.changeFlagBon = false;
// 提交变量
$scope.isSubmit = false;
// form 提交时的方法
$scope.submitValid = function (isValid,userForm) {
if(!isValid) {
// 提交的时候所有的输入框都设置为已经使用
userForm.userName.$pristine =false;
userForm.password.$pristine =false;
userForm.email.$pristine =false;
$scope.changeFlagBon = true;
// 处理更详细的验证
// 提交变量设置为已经提交
$scope.isSubmit = true;
$('#showMsg').text("验证不通过,请检查!");
$('#showMsgDiv').modal();
}else {
// 处理提交逻辑
}
}
// ng-blur ng-focus 获取焦点,失去焦点方法
$scope.changeFlag = function (flag) {
$scope.changeFlagBon = flag;
}
});
index.html
<!DOCTYPE html>
<html lang="en" ng-app="formApp">
<head>
<meta charset="UTF-8">
<title>表单验证</title>
<link rel="stylesheet" href="/bootstrap-3.3.7/dist/css/bootstrap.css">
<link rel="stylesheet" href="/bootstrap-3.3.7/dist/css/bootstrap-theme.min.css">
<script src="/lib/angular/angular.js"></script>
<script src="/lib/angular-messages/angular-messages.js"></script>
<script src="../../js/jquery-1.9.1/jquery.js"></script>
<script src="/bootstrap-3.3.7/dist/js/bootstrap.js"></script>
<script src="app.js"></script>
<style>
body
{ padding-top:30px;
padding-left: 600px;
}
</style>
</head>
<body ng-controller="formController">
<di class = 'page-header'><h3>AngularJs 表单验证</h3></di>
<!-- novalidate 禁用自带的验证规则-->
<form name ='userForm' novalidate ng-submit="submitValid(userForm.$valid,userForm)" style="width: 300px;">
<div class="form-group" style="height: 70px;" ng-class="{'has-error' : userForm.userName.$invalid && !userForm.userName.$pristine}">
<label>用户名</label>
<input type="text" class="form-control" name="userName" ng-model="userName" required
ng-model-options="{ updateOn: 'blur' }">
<!--必填单纯判断会在页面加载的时候就显示错误提示,可以先判断表单是否未使用$pristine 可以避免页面加载进来就提示错误-->
<span ng-show="userForm.userName.$invalid && !userForm.userName.$pristine" class="help-block">必填项</span>
</div>
<div class="form-group" style="height: 70px;" ng-class="{'has-error' :isSubmit && userForm.password.$invalid && !userForm.password.$pristine}">
<label>密码</label>
<input type="text" class="form-control" name="password" ng-model="password" required
ng-pattern="/^[A-Za-z0-9]+$/" ng-minlength="8" ng-maxlength="16"
ng-model-options="{ updateOn: 'blur' }">
<!--这里有2个验证规则,第一个是只能是数字或者字母,第二个是长度要在8-16位 使用ng-messages优先提示格式,然后提示长度-->
<div ng-messages="userForm.password.$error" ng-if="isSubmit">
<span ng-message="pattern" class="help-block">密码只能是数字或英文字母</span>
<span ng-message="minlength" class="help-block">密码长度最短8位</span>
<span ng-message="maxlength" class="help-block">密码长度最长16位</span>
<span ng-message="required" class="help-block">密码必填</span>
</div>
</div>
<div class="form-group" style="height: 70px;" ng-class="{'has-error' : changeFlagBon && userForm.email.$invalid && !userForm.email.$pristine}">
<label>邮箱</label>
<input type="email" class="form-control" name="email" ng-model="email" required
ng-blur="changeFlag(true)" ng-focus="changeFlag(false)">
<span ng-show="changeFlagBon && userForm.email.$invalid && !userForm.email.$pristine" class="help-block">邮箱格式错误</span>
</div>
<button type="submit" class="btn btn-primary">提交</button>
</form>
<!-- 模态弹出窗 -->
<div class="modal fade" id="showMsgDiv">
<div class="modal-dialog">
<div class="modal-content">
<div class="modal-header">
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
<h4 class="modal-title">提示信息</h4>
</div>
<div class="modal-body">
<p id="showMsg"></p>
</div>
<div class="modal-footer">
<button type="button" class="btn btn-default" data-dismiss="modal">关闭</button>
<!--<button type="button" class="btn btn-primary">保存</button>-->
</div>
</div><!-- /.modal-content -->
</div><!-- /.modal-dialog -->
</div><!-- /.modal -->
</body>
</html>

网友评论