表單驗證是業務開發中密度最高的場景之一。AngularJS 把驗證狀態做成了內建能力,只要幾個屬性和指令,就能實現禁用提交、顯示錯誤、動態樣式等一系列效果。本文按需求逐步推進,做出一個完整可用的驗證表單。
Angular 會自動為表單和每個輸入框維護狀態,並同步成對應的 CSS 類名:
| 屬性 | 類名 | 說明 |
|---|---|---|
| $valid | ng-valid | 當前項按規則驗證通過 |
| $invalid | ng-invalid | 當前項驗證未通過 |
| $pristine | ng-pristine | 表單或輸入框尚未被使用過 |
| $dirty | ng-dirty | 表單或輸入框已被修改過 |
訪問方式:表單用 表單名.屬性,輸入框用 表單名.輸入框名.屬性。此外還有 $error 對象,可以按具體規則名(如 required、minlength、email)精確定位失敗原因。
我們需要兩個文件:index.html 放表單,app.js 放應用與控制器。

<!-- index.html -->
<!DOCTYPE html>
<html>
<head>
<link rel="stylesheet" href="https://netdna.bootstrapcdn.com/bootstrap/3.0.3/css/bootstrap.min.css">
<style> body { padding-top:30px; } </style>
<script src="https://code.angularjs.org/1.2.6/angular.js"></script>
<script src="app.js"></script>
</head>
<body ng-app="validationApp" ng-controller="mainController">
<div class="container">
<div class="col-sm-8 col-sm-offset-2">
<div class="page-header"><h1>AngularJS Form Validation</h1></div>
<!-- novalidate 阻止瀏覽器默認的 HTML5 驗證 -->
<form name="userForm" ng-submit="submitForm(userForm.$valid)" novalidate>
<!-- NAME:必填 -->
<div class="form-group">
<label>Name</label>
<input type="text" name="name" class="form-control" ng-model="name" required>
</div>
<!-- USERNAME:長度 3~8 -->
<div class="form-group">
<label>Username</label>
<input type="text" name="username" class="form-control"
ng-model="user.username" ng-minlength="3" ng-maxlength="8">
</div>
<!-- EMAIL:type=email 自帶格式校驗 -->
<div class="form-group">
<label>Email</label>
<input type="email" name="email" class="form-control" ng-model="email">
</div>
<button type="submit" class="btn btn-primary">Submit</button>
</form>
</div>
</div>
</body>
</html>
幾個關鍵點:
novalidate:關閉瀏覽器原生 HTML5 驗證,交給 Angular 統一處理,否則兩套提示會互相打架。ng-model:把表單數據綁定到 Angular 變量。ng-minlength / ng-maxlength:聲明式地創建長度規則。required:直接沿用 HTML 原生屬性,Angular 同樣會識別。type="email":Angular 會自動為 email 類型輸入框附加格式校驗。
<input ng-model="{ string }"
name="{ string }"
required
ng-required="{ boolean }"
ng-minlength="{ number }"
ng-maxlength="{ number }"
ng-pattern="{ string }"
ng-change="{ string }">
ng-required 支持傳表達式,可以實現「某個條件成立時才必填」的動態規則;ng-pattern 則支持自定義正則。
// app.js
var validationApp = angular.module('validationApp', []);
validationApp.controller('mainController', function ($scope) {
$scope.submitForm = function (isValid) {
if (isValid) {
alert('our form is amazing');
}
};
});

<button type="submit" class="btn btn-primary" ng-disabled="userForm.$invalid">Submit</button>
一行 ng-disabled 即可:只要表單處於 $invalid,按鈕自動禁用。此時 Name 必填、Email 格式正確這兩個條件任一不滿足,都無法提交。
<!-- NAME -->
<div class="form-group">
<label>Name</label>
<input type="text" name="name" class="form-control" ng-model="name" required>
<p ng-show="userForm.name.$invalid && !userForm.name.$pristine"
class="help-block">You name is required.</p>
</div>
<!-- USERNAME -->
<div class="form-group">
<label>Username</label>
<input type="text" name="username" class="form-control"
ng-model="user.username" ng-minlength="3" ng-maxlength="8">
<p ng-show="userForm.username.$error.minlength" class="help-block">Username is too short.</p>
<p ng-show="userForm.username.$error.maxlength" class="help-block">Username is too long.</p>
</div>
<!-- EMAIL -->
<div class="form-group">
<label>Email</label>
<input type="email" name="email" class="form-control" ng-model="email">
<p ng-show="userForm.email.$invalid && !userForm.email.$pristine"
class="help-block">Enter a valid email.</p>
</div>

這裡的 !userForm.name.$pristine 很重要:用戶還沒碰過這個輸入框時不顯示報錯,否則一進頁面就滿屏紅字,體驗很差。而 username 因為有兩種失敗原因,直接用 $error.minlength 與 $error.maxlength 分別給出針對性提示,比一句「格式錯誤」友好得多。
Angular 在驗證時會自動切換 ng-valid、ng-invalid、ng-pristine、ng-dirty 這些類,你可以直接覆蓋:
.ng-valid { }
.ng-invalid { }
.ng-pristine { }
.ng-dirty { }
/* Angular 還會加上更精細的類 */
.ng-invalid-required { }
.ng-invalid-minlength { }
.ng-valid-max-length { }
項目裡用了 Bootstrap,可以直接借用它的 has-error:
<div class="form-group"
ng-class="{ 'has-error' : userForm.name.$invalid && !userForm.name.$pristine }">
<label>Name</label>
<input type="text" name="name" class="form-control" ng-model="user.name" required>
<p ng-show="userForm.name.$invalid && !userForm.name.$pristine"
class="help-block">You name is required.</p>
</div>
語法為 ng-class="{ '類名' : 表達式 }"。username 與 email 兩個 form-group 按同樣方式加上即可,輸入框邊框和提示文字就會變紅。

並非所有產品都喜歡「邊打字邊報錯」。想改成提交後才驗證,做三件事:
ng-disabled,讓用戶隨時可以點。submitForm() 裡加一行 $scope.submitted = true;。ng-show / ng-class 的條件末尾追加 && submitted,例如 ng-class="{ 'has-error' : userForm.name.$invalid && !userForm.name.$pristine && submitted }"。這樣錯誤提示只會在用戶主動提交之後出現,打斷感更低。
「離開輸入框時驗證」比提交時驗證更複雜一些,需要自定義指令(directive)來介入 DOM 事件。Angular 本身沒有內建 blur 校驗,常見做法是寫一個 ngBlur 類型的自定義指令,在 blur 事件中把某個狀態標記為已校驗。這部分可以後續單獨展開。

幾行聲明式代碼就換來了:輸入框實時校驗、針對性錯誤提示、樣式類自動切換、提交按鈕自動啟禁用、自定義規則擴展。相比手寫一堆 onblur 與 if 判斷,Angular 的表單驗證把狀態管理交給了框架,業務代碼只關心規則本身。