DIV CSS 佈局教程網

AngularJS 表單驗證全流程詳解
編輯:JavaScript綜合知識     

表單驗證是業務開發中密度最高的場景之一。AngularJS 把驗證狀態做成了內建能力,只要幾個屬性和指令,就能實現禁用提交、顯示錯誤、動態樣式等一系列效果。本文按需求逐步推進,做出一個完整可用的驗證表單。

需求清單

  • Name:必填。
  • Username:非必填,最小長度 3,最大長度 8。
  • Email:非必填,但必須是合法的 email 格式。
  • 驗證未通過時不能提交。
  • 顯示必填或 email 格式錯誤的提示信息。
  • 提交成功後彈出祝賀提示。

Angular 提供的表單狀態屬性

Angular 會自動為表單和每個輸入框維護狀態,並同步成對應的 CSS 類名:

屬性類名說明
$validng-valid當前項按規則驗證通過
$invalidng-invalid當前項驗證未通過
$pristineng-pristine表單或輸入框尚未被使用過
$dirtyng-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 類型輸入框附加格式校驗。

AJAX 可用的驗證規則

<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 分別給出針對性提示,比一句「格式錯誤」友好得多。

第五步:用 CSS 類做樣式

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   { }

第六步:用 ng-class 按條件掛類

項目裡用了 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 按同樣方式加上即可,輸入框邊框和提示文字就會變紅。

進階:只在提交後顯示錯誤

並非所有產品都喜歡「邊打字邊報錯」。想改成提交後才驗證,做三件事:

  1. 去掉提交按鈕上的 ng-disabled,讓用戶隨時可以點。
  2. 在 submitForm() 裡加一行 $scope.submitted = true;。
  3. 把所有 ng-show / ng-class 的條件末尾追加 && submitted,例如 ng-class="{ 'has-error' : userForm.name.$invalid && !userForm.name.$pristine && submitted }"。

這樣錯誤提示只會在用戶主動提交之後出現,打斷感更低。

進階:失焦(blur)時才驗證

「離開輸入框時驗證」比提交時驗證更複雜一些,需要自定義指令(directive)來介入 DOM 事件。Angular 本身沒有內建 blur 校驗,常見做法是寫一個 ngBlur 類型的自定義指令,在 blur 事件中把某個狀態標記為已校驗。這部分可以後續單獨展開。

最終效果

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

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved