AngularJS表单验证详解：内置指令、状态属性与自定义验证
本文深入解析AngularJS中的表单验证机制，涵盖必填、长度、模式匹配等内置指令的使用，以及$pristine、$valid等状态属性的应用。通过实例演示如何结合HTML5与AngularJS特性，并利用ngModelController实现自定义验证逻辑，帮助开发者构建健壮的前端表单交互。
AngularJS表单验证入门指南：
AngularJS内置表单验证指令
常用表单验证指令概览 1. 必填项校验
判断表单输入框是否已填写，只需在输入元素上添加HTML5属性required：
示例代码：
<<input type="text" required />2. 最小长度限制
检查输入文本长度是否超过指定最小值，在输入字段应用指令ng-minlength="{number}"：
示例代码：
<<input type="text" ng-minlength="5" />3. 最大长度限制
检查输入文本长度是否不超过指定最大值，在输入字段应用指令ng-maxlength="{number}"：
示例代码：
<<input type="text" ng-maxlength="20" />4. 正则匹配
利用ng-pattern="/PATTERN/"确保输入内容符合指定的正则表达式规则：
示例代码：
<<input type="text" ng-pattern="/[a-zA-Z]/" />5. 邮箱格式
校验输入是否为有效邮箱，只需将input类型设为email：
示例代码：
<input type="email" name="email" ng-model="user.email" />6. 数字类型
校验输入是否为数字，将input类型设为number：
示例代码：
<<input type="number" name="age" ng-model="user.age" />7. URL地址
校验输入是否为有效URL，将input类型设为url：
示例代码：
<<input type="url" name="homepage" ng-model="user.facebook_url" />接下来通过具体实例测试上述表单验证功能：
<div class="col-md-6">
<form role="form" class="form-horizontal">
<div class="form-group">
<div class="col-md-4">
<label for="name">1.必填项</label>
</div>
<div class="col-md-8">
<input class="form-control" id="name" type="text" required ng-model='user.name' />
</div>
</div>
<div class="form-group">
<div class="col-md-4">
<label for="minlength">2.最小长度=5</label>
</div>
<div class="col-md-8">
<input type="text" id="minlength" ng-minlength="5" ng-model="user.minlength" class="form-control" />
</div>
</div>
<div class="form-group">
<div class="col-md-4">
<label for="minlength">3.最大长度=20</label>
</div>
<div class="col-md-8">
<input type="text" ng-model="user.maxlength" ng-maxlength="20" class="form-control" />
</div>
</div>
<div class="form-group">
<div class="col-md-4">
<label for="minlength">4. 模式匹配</label>
</div>
<div class="col-md-8">
<input type="text" id="minlength" ng-model="user.pattern" ng-pattern="/^[a-zA-Z]*\d$/" class="form-control" />
</div>
</div>
<div class="form-group">
<div class="col-md-4">
<label for="email">5. 电子邮件</label>
</div>
<div class="col-md-8">
<input type="email" id="email" name="email" ng-model="user.email" class="form-control" />
</div>
</div>
<div class="form-group">
<div class="col-md-4">
<label for="age">6. 数字</label>
</div>
<div class="col-md-8">
<input type="number" id="age" name="age" ng-model="user.age" class="form-control" />
</div>
</div>
<div class="form-group">
<div class="col-md-4">
<label for="url"> 7. URL</label>
</div>
<div class="col-md-8">
<input type="url" id="url" name="homepage" ng-model="user.url" class="form-control" />
</div>
</div>
<div class="form-group text-center">
<input class="btn btn-primary btn-lg" type="submit" value="提交" />
</div>
</form>
</div>
<div class="col-md-12">
1.必填项:{{user.name}}<br>
2.最小长度=5:{{user.minlength}}<br>
3.最大长度=20:{{user.maxlength}}<br>
4.模式匹配:{{user.pattern}}<br>
5.电子邮件:{{user.email}}<br>
6.数字:{{user.age}}<br>
7.URL:{{user.url}}<br>
</div>
测试表明，仅当表达式满足验证条件时，双向绑定才会实时生效。同时观察到的效果如下：
看似无异常，但若将此例移植至对HTML5验证支持不佳的浏览器（如【本例IE9】），则会出现部分字段无法验证的问题。
上述示例结合了HTML5原生验证与AngularJS自身验证机制。对于不支持HTML5验证的环境，AngularJS的独立验证机制仍能良好运行。解决此类问题的方案包括使用模式匹配覆盖上述情况，或自定义验证指令以重写/重定义验证规则。
表单状态属性与错误处理
禁用浏览器默认表单验证行为 在表单元素上添加novalidate属性即可。关键在于如何判断表单中哪些字段有效，哪些非法或无效？AngularJS提供了卓越解决方案：表单属性可通过其所属的$scope对象访问，进而通过JavaScript间接操作DOM中的表单属性。利用这些属性，可实现表单的实时响应。
可通过formName.inputFieldName.property格式访问这些属性。
未修改状态的表单
布尔属性，标识用户是否修改过表单。若为true，表示未修改；若为false，表示已修改formName.inputFieldName.$pristine;
已修改状态的表单
布尔属性，仅当用户实际修改过表单时为真。无论表单是否通过验证：formName.inputFieldName.$dirty
验证通过的表单
布尔属性，指示表单是否通过验证。若当前通过验证，该值为true：formName.inputFieldName.$valid
未通过验证的表单:formName.inputFieldName.$invalid
最后两个属性在控制DOM元素显示或隐藏时尤为有用。同时，在设置特定CSS类时，它们也非常关键。
错误信息 这是AngularJS提供的另一项极具价值的属性：$error对象。它包含当前表单的所有验证内容及合法性信息。通过以下语法访问此属性：
formName.inputfieldName.$error 若验证失败，该属性值为true；若为false，则表明输入字段值已通过验证。
接下来对这些验证指令进行测试：
<!DOCTYPE html>
<html ng-app="myTest">
<head>
<meta name="viewport" content="width=device-width" />
<title>Index</title>
<link href="~/Content/css/bootstrap.min.css" rel="stylesheet" />
<script src="~/Javascript/angular.min.js"> </script>
<style type="text/css">
body { padding-top: 30px; }
</style>
</head>
<body ng-Controller="MyController">
<div class="col-md-6">
<form role="form" name="myForm" ng-submit="submitForm(myForm.$valid)" class="form-horizontal" novalidate>
<div class="form-group has-feedback">
<div class="col-md-4">
<label for="name">1.必填项</label>
</div>
<div class="col-md-8">
<input class="form-control" id="name" name="name" type="text" required ng-model='user.name' />
<span class="glyphicon glyphicon-ok form-control-feedback"
ng-show="myForm.name.$dirty && myForm.name.$valid"></span>
</div>
</div>
<div class="form-group has-feedback">
<div class="col-md-4">
<label for="minlength">2.最小长度=5</label>
</div>
<div class="col-md-8">
<input type="text" id="minlength" name="minlength" ng-minlength="5" ng-model="user.minlength" class="form-control" />
<span class="glyphicon glyphicon-ok form-control-feedback"
ng-show="myForm.minlength.$dirty && myForm.minlength.$valid"></span>
</div>
</div>
<div class="form-group has-feedback">
<div class="col-md-4">
<label for="maxlength">3.最大长度=20</label>
</div>
<div class="col-md-8">
<input type="text" id="maxlength" name="maxlength" ng-model="user.maxlength" ng-maxlength="20" class="form-control" />
<span class="glyphicon glyphicon-ok form-control-feedback"
ng-show="myForm.maxlength.$dirty && myForm.maxlength.$valid"></span>
</div>
</div>
<div class="form-group has-feedback">
<div class="col-md-4">
<label for="pattern">4. 模式匹配</label>
</div>
<div class="col-md-8">
<input type="text" id="pattern" name="pattern" ng-model="user.pattern" ng-pattern="/^[a-zA-Z]*\d$/" class="form-control" />
<span class="glyphicon glyphicon-ok form-control-feedback"
ng-show="myForm.pattern.$dirty && myForm.pattern.$valid"></span>
</div>
</div>
<div class="form-group has-feedback">
<div class="col-md-4">
<label for="email">5. 电子邮件</label>
</div>
<div class="col-md-8">
<input type="email" id="email" name="email" ng-model="user.email" class="form-control" />
<span class="glyphicon glyphicon-ok form-control-feedback"
ng-show="myForm.email.$dirty && myForm.email.$valid"></span>
</div>
</div>
<div class="form-group has-feedback">
<div class="col-md-4">
<label for="age">6. 数字</label>
</div>
<div class="col-md-8">
<input type="number" id="age" name="age" ng-model="user.age" class="form-control" />
<span class="glyphicon glyphicon-ok form-control-feedback"
ng-show="myForm.age.$dirty && myForm.age.$valid"></span>
</div>
</div>
<div class="form-group has-feedback">
<div class="col-md-4">
<label for="url"> 7. URL</label>
</div>
<div class="col-md-8">
<input type="url" id="url" name="url" ng-model="user.url" class="form-control" />
<span class="glyphicon glyphicon-ok form-control-feedback"
ng-show="myForm.url.$dirty && myForm.url.$valid"></span>
</div>
</div>
<div class="form-group text-center">
<input class="btn btn-primary btn-lg" ng-disabled="myForm.$invalid" type="submit" value="提交" />
</div>
</form>
</div>
<div class="col-md-12">
1.必填项:{{user.name}}
$pristine 【没修改】：{{myForm.name.$pristine }}
$dirty【修改过】：{{myForm.name.$dirty}}
$invalid【验证失败】：{{myForm.name.$invalid}}
$invalid【验证成功】：{{myForm.name.$valid}}
required：{{myForm.name.$error.required}}
<br>
2.最小长度=5:{{user.minlength}}
$pristine 【没修改】：{{myForm.minlength.$pristine }}
$dirty【修改过】：{{myForm.minlength.$dirty}}
$invalid【验证失败】：{{myForm.minlength.$invalid}}
$invalid【验证成功】：{{myForm.minlength.$valid}}
$error【错误详情】：{{myForm.minlength.$error}} <br>
3.最大长度=20:{{user.maxlength}}
$pristine 【没修改】：{{myForm.maxlength.$pristine }}
$dirty【修改过】：{{myForm.maxlength.$dirty}}
$invalid【验证失败】：{{myForm.maxlength.$invalid}}
$invalid【验证成功】：{{myForm.maxlength.$valid}}
$error【错误详情】：{{myForm.maxlength.$error}} <br>
4.模式匹配:{{user.pattern}}
$pristine 【没修改】：{{myForm.pattern.$pristine }}
$dirty【修改过】：{{myForm.pattern.$dirty}}
$invalid【验证失败】：{{myForm.pattern.$invalid}}
$invalid【验证成功】：{{myForm.pattern.$valid}}
$error【错误详情】：{{myForm.pattern.$error}} <br>
5.电子邮件:{{user.email}}
$pristine 【没修改】：{{myForm.email.$pristine }}
$dirty【修改过】：{{myForm.email.$dirty}}
$invalid【验证失败】：{{myForm.email.$invalid}}
$invalid【验证成功】：{{myForm.email.$valid}}
$error【错误详情】：{{myForm.email.$error}} <br>
6.数字:{{user.age}}
$pristine 【没修改】：{{myForm.age.$pristine }}
$dirty【修改过】：{{myForm.age.$dirty}}
$invalid【验证失败】：{{myForm.age.$invalid}}
$invalid【验证成功】：{{myForm.age.$valid}}
$error【错误详情】：{{myForm.age.$error}} <br>
7.URL:{{user.url}}
$pristine 【没修改】：{{myForm.url.$pristine }}
$dirty【修改过】：{{myForm.url.$dirty}}
$invalid【验证失败】：{{myForm.url.$invalid}}
$invalid【验证成功】：{{myForm.url.$valid}}
$error【错误详情】：{{myForm.url.$error}} <br>
</div>
</body>
</html>
<script type="text/javascript">
angular.module('myTest', [])
.controller('myController', function($scope) {
$scope.submitForm = function(isValid) {
if (!isValid) {
alert('验证失败');
}
};
}
);
</script>
运行效果如下：
同时，AngularJS针对这几种验证指令，针对性地预设了一些CSS样式
具体包括：
.ng-valid { }
.ng-invalid { }
.ng-pristine { }
.ng-dirty { }
/* really specific css rules applied by angular */
.ng-invalid-required { }
.ng-invalid-minlength { }
.ng-valid-max-length { }
它们对应着表单输入字段的特定状态。 例如，当某个字段中的输入非法时，.ng-invalid类会被添加到这个字段上。 你可以编辑自己喜欢的CSS . 你可以私有定制化这些类来实现特定的场景应用.
自定义验证指令与ngModelController
然而，默认的验证指令未必能完全满足真实应用场景的需求，AngularJS同样提供了自定义验证指令的功能。
首先来看一个简单的示例：
angular.module("myTest", [])
.directive('multipleEmail', [function () {
return {
require: "ngModel",
link: function (scope, element, attr, ngModel) {
if (ngModel) {
var emailsRegexp = /^([a-z0-9!#$%&'*+\/=?^_`{|}~.-]+@[a-z0-9-]+(\.[a-z0-9-]+)*[;；]?)+$/i;
}
var customValidator = function (value) {
var validity = ngModel.$isEmpty(value) || emailsRegexp.test(value);
ngModel.$setValidity("multipleEmail", validity);
return validity ? value : undefined;
};
ngModel.$formatters.push(customValidator);
ngModel.$parsers.push(customValidator);
}
};
}])页面HTML部分代码如下：
<form class="form-horizontal" role="form" id="custom_form" name="custom_form" novalidate>
<div class="form-group">
<label class="col-sm-2 control-label">多个email</label>
<div class="col-sm-10">
<input multiple-email name="user_email" ng-model="user.email" required class="form-control" placeholder="自定义验证，多个邮箱地址，以“；”或者“;”分割" />
验证通过：{{custom_form.user_email.$valid}}
</div>
</div>
<div class="form-group text-center">
<input class="btn btn-primary btn-lg" ng-disabled="custom_form.$invalid" type="submit" value="提交" />
</div>
</form>
代码非常简洁，实现效果如下所示：
这段代码虽然简单，但涉及到了ngModelController的几个重要属性 $viewValue
$viewValue属性保存着更新视图所需的实际字符串。
$modelValue
$modelValue由数据模型持有。$modelValue和$viewValue可能是不同的，取决于$parser流水线是否对其进行了操作。
$parsers
$parsers的值是一个由函数组成的数组，当用户同控制器进行交互，并且ngModelController中的$setViewValue()方法被调用时，其中的函数在当用户同控制器进行交互，并且ngModelController中的$setViewValue()方法被调会以流水线的形式被逐一调用。ngModel从DOM中读取的值会被传入$parsers中的函数，并依次被其中的解析器处理。这是为了对值进行处理和修饰。
备注：ngModel.$setViewValue()函数用于设置作用域中的视图值。
ngModel.$set ViewValue()函数可以接受一个参数。
value（字符串）：value参数是我们想要赋值给ngModel实例的实际值。
这个方法会更新控制器上本地的$viewValue，然后将值传递给每一个$parser函数（包括验证器）。当值被解析，且$parser流水线中所有的函数都调用完成后，值会被赋给$modelValue属性，并且传递给指令中ng-model属性提供的表达式。最后，所有步骤都完成后，$viewChangeListeners中所有的监听器都会被调用。注意，单独调用$setViewValue()不会唤起一个新的digest循环，因此如果想更新指令，需要在设置$viewValue后手动触发digest。$setViewValue()方法适合于在自定义指令中监听自定义事件（比如使用具有回调函数的jQuery插件），我们会希望在回调时设置$viewValue并执行digest循环。
$formatters
$formatters的值是一个由函数组成的数组，其中的函数会以流水线的形式在数据模型的值发生变化时被逐一调用。它和$parser流水线互不影响，用来对值进行格式化和转换，以便在绑定了这个值的控件中显示。
$viewChangeListeners
$viewChangeListeners的值是一个由函数组成的数组，其中的函数会以流水线的形式在视图中的值发生变化时被逐一调用。通过$viewChangeListeners，可以在无需使用$watch的情况下实现类似的行为。由于返回值会被忽略，因此这些函数不需要返回值。
$error
$error对象中保存着没有通过验证的验证器名称以及对应的错误信息。
$pristine
$pristine的值是布尔型的，可以告诉我们用户是否对控件进行了修改。
$dirty
$dirty的值和$pristine相反，可以告诉我们用户是否和控件进行过交互。
$valid
$valid值可以告诉我们当前的控件中是否有错误。当有错误时值为false，没有错误时值为true。
$invalid
$invalid值可以告诉我们当前控件中是否存在至少一个错误，它的值和$valid相反。
以上就是本文的全部内容，希望对大家实现AngularJS表单验证有所帮助。
免登录快速分享代码：适合面试协作的轻量级JS在线运行工具推荐
2026-11-05 14:45:59
JS空字符串和纯空格转浮点数的结果是什么
2026-11-05 11:04:42
JS在线格式化缩进混乱怎么办？配置项调整技巧
2026-11-04 23:27:25
JS怎么获取秒级时间戳
2026-11-03 21:45:29
JS时间戳怎么从毫秒转换为秒
2026-11-03 20:04:14