
表單驗證是前端最反覆的工作之一:必填檢查、長度限制、錯誤狀態顯示、送出按鈕的啟停。用傳統寫法往往要綁一堆事件、維護一堆狀態旗標。改用 AngularJS 之後,這些大多能靠宣告式的模板語法解決,JavaScript 那邊幾乎不用寫。
畫面上的表單需要滿足:所有欄位皆為必填、各自限制最大長度、首次進入頁面時不得顯示錯誤狀態、輸入後再清空時要立即提示必填錯誤、只有全部欄位合法時「發布」按鈕才可按。
<!DOCTYPE html>
<html lang="zh-cn" ng-app="ftitApp">
<head>
<meta charset="utf-8" />
<title>Demo</title>
<link href="/Content/bootstrap.css" rel="stylesheet"/>
<script src="/Scripts/angular.js"></script>
</head>
<body>
<div class="container body-content">
<div class="row main-content">
<div class="col-md-9">
<form action="/Contact/Create" method="post" role="form"
name="createContactForm" ng-controller="ContactCreateController">
<!-- 您的稱呼 -->
<div class="form-group has-feedback"
ng-class="{'has-success': !createContactForm.UserName.$pristine && createContactForm.UserName.$valid,
'has-error' : !createContactForm.UserName.$pristine && createContactForm.UserName.$invalid}">
<label for="UserName">您的稱呼*</label>
<input type="text" class="form-control" ng-model="userName"
name="UserName" autofocus required ng-maxlength="30">
<span class="glyphicon glyphicon-ok form-control-feedback"
ng-show="!createContactForm.UserName.$pristine && createContactForm.UserName.$valid"></span>
<span class="glyphicon glyphicon-remove form-control-feedback"
ng-show="!createContactForm.UserName.$pristine && createContactForm.UserName.$invalid"></span>
</div>
<!-- 郵箱地址 -->
<div class="form-group has-feedback"
ng-class="{'has-success': !createContactForm.UserMail.$pristine && createContactForm.UserMail.$valid,
'has-error' : !createContactForm.UserMail.$pristine && createContactForm.UserMail.$invalid}">
<label for="UserMail">郵箱地址*</label>
<input type="email" class="form-control" ng-model="userMail"
name="UserMail" required ng-maxlength="30">
<span class="glyphicon glyphicon-ok form-control-feedback"
ng-show="!createContactForm.UserMail.$pristine && createContactForm.UserMail.$valid"></span>
<span class="glyphicon glyphicon-remove form-control-feedback"
ng-show="!createContactForm.UserMail.$pristine && createContactForm.UserMail.$invalid"></span>
</div>
<!-- 主題 -->
<div class="form-group has-feedback"
ng-class="{'has-success': !createContactForm.Subject.$pristine && createContactForm.Subject.$valid,
'has-error' : !createContactForm.Subject.$pristine && createContactForm.Subject.$invalid}">
<label for="Subject">主題*</label>
<input type="text" class="form-control" ng-model="subject"
name="Subject" required ng-maxlength="100">
</div>
<!-- 內容 -->
<div class="form-group has-feedback"
ng-class="{'has-success': !createContactForm.Content.$pristine && createContactForm.Content.$valid,
'has-error' : !createContactForm.Content.$pristine && createContactForm.Content.$invalid}">
<label for="Content">內容*</label>
<textarea cols="4" rows="5" class="form-control" ng-model="content"
name="Content" required ng-maxlength="1000"></textarea>
</div>
<!-- 發布按鈕 -->
<div class="form-group">
<div ng-show="createContactForm.$valid">
<input type="image" src="/Content/images/comment_publish_button.png"
value="發布" ng-disabled="!createContactForm.$valid" />
</div>
<div ng-show="!createContactForm.$valid">
<img src="/Content/images/invalid_publish_button.png" />
</div>
</div>
</form>
</div>
</div>
</div>
<script src="/Scripts/ftit/ContactCreateController.js"></script>
</body>
</html>
var ftitAppModule = angular.module('ftitApp', []);
ng-class:控制 class 的值。例如 {'has-success': !createContactForm.Content.$pristine && createContactForm.Content.$valid} 的意思是,當表單物件的 Content 欄位「已被互動過且內容合法」時,套上 has-success 樣式。
ng-show:控制元素是否顯示,這裡用來切換成功與失敗的提示圖示。
$valid / $invalid:該欄位是否通過驗證。
$pristine:該欄位是否從未被輸入過。這正是「第一次打開頁面不要顯示紅色錯誤」的關鍵——只要加上 !$pristine 條件,未經互動的欄位就不會被判定為錯誤狀態。
ng-maxlength:宣告式地限制最大長度,同時參與驗證計算。
傳統做法需要手動維護「每個欄位是否合法」「使用者是否碰過」這些狀態,還要在每次輸入後重新計算按鈕該不該亮。AngularJS 把表單本身變成一個可觀察的物件,狀態變化會自動反映到視圖上,因此我們只需要描述「什麼條件下長什麼樣子」,不必一步步操作 DOM。
補充兩點實務經驗:表單的 name 屬性一定要設,AngularJS 是靠它把欄位掛到表單物件上的;另外前端驗證只是使用者體驗層,伺服器端仍必須重跑一次相同的規則,否則只要繞過前端就能送出任意內容。