AngularJS表單驗證

 

最近在研究AngularJS,恰好遇到了表單驗證問題。

沒有那麼多時間去寫原創文章,恰好找到一篇不寫得相當棒的文章。

自己記一下,也分享給大家。

此文原文出處:http://www.cnblogs.com/rohelm/p/4033513.html

 

表單驗證<AngularJs>

 

常用的表單驗證指令 

1. 必填項驗證

某個表單輸入是否已填寫,只要在輸入字段元素上添加HTML5標記required即可:

<input type="text" required />  

2. 最小長度

驗證表單輸入的文本長度是否大於某個最小值,在輸入字段上使用指令ng-minleng= "{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的驗證與ng自有的驗證進行了結合,不支持HTML5驗證,但ng自由驗證運行良好。解決方案很簡單,可以使用模式匹配的方式解決這幾種情況,也可以自定義驗證指令來複寫或者重定義驗證規則。

屏蔽瀏覽器對錶單的默認驗證行爲

在表單元素上添加novalidate標記即可,問題是我們怎麼知道我們的表單有哪些字段是有效的,那些事非法或者無效的?ng對此也提供了非常棒的解決方案,表單的屬性可以在其所屬的$scope對象中訪問到,而我們又可以訪問$scope對象,因此JavaScript可以間接地訪問DOM中的表單屬性。藉助這些屬性,我們可以對錶單做出實時響應。

可以使用formName.inputFieldName.property的格式訪問這些屬性。

未修改過的表單

布爾值屬性,表示用戶是否修改了表單。如果爲ture,表示沒有修改過;false表示修改過:

formName.inputFieldName.$pristine;

修改的表單

布爾型屬性,當且僅當用戶實際已經修改的表單。不管表單是否通過驗證:

formName.inputFieldName.$dirty

 

經過驗證的表單

布爾型屬性,它指示表單是否通過驗證。如果表單當前通過驗證,他將爲true:

formName.inputFieldName.$valid

未通過驗證的表單

formName.inputFieldName.$invalid

 

最後兩個屬性在用於DOM元素的顯示或隱藏時是特別有用的。同時,如果要設置特定的class時,他們也非常有用的。

錯誤

這是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}}&nbsp;&nbsp;
            $pristine 【沒修改】:{{myForm.name.$pristine }}&nbsp;&nbsp;
            $dirty【修改過】:{{myForm.name.$dirty}}&nbsp;&nbsp;
            $invalid【驗證失敗】:{{myForm.name.$invalid}}&nbsp;&nbsp;
            $invalid【驗證成功】:{{myForm.name.$valid}}&nbsp;&nbsp;
            required:{{myForm.name.$error.required}}&nbsp;&nbsp;
            <br>
            2.最小長度=5:{{user.minlength}}
            $pristine 【沒修改】:{{myForm.minlength.$pristine }}&nbsp;&nbsp;
            $dirty【修改過】:{{myForm.minlength.$dirty}}&nbsp;&nbsp;
            $invalid【驗證失敗】:{{myForm.minlength.$invalid}}&nbsp;&nbsp;
            $invalid【驗證成功】:{{myForm.minlength.$valid}}&nbsp;&nbsp;
            $error【錯誤詳情】:{{myForm.minlength.$error}}&nbsp;&nbsp;<br>
            3.最大長度=20:{{user.maxlength}}
            $pristine 【沒修改】:{{myForm.maxlength.$pristine }}&nbsp;&nbsp;
            $dirty【修改過】:{{myForm.maxlength.$dirty}}&nbsp;&nbsp;
            $invalid【驗證失敗】:{{myForm.maxlength.$invalid}}&nbsp;&nbsp;
            $invalid【驗證成功】:{{myForm.maxlength.$valid}}&nbsp;&nbsp;
            $error【錯誤詳情】:{{myForm.maxlength.$error}}&nbsp;&nbsp;<br>
            4.模式匹配:{{user.pattern}}
            $pristine 【沒修改】:{{myForm.pattern.$pristine }}&nbsp;&nbsp;
            $dirty【修改過】:{{myForm.pattern.$dirty}}&nbsp;&nbsp;
            $invalid【驗證失敗】:{{myForm.pattern.$invalid}}&nbsp;&nbsp;
            $invalid【驗證成功】:{{myForm.pattern.$valid}}&nbsp;&nbsp;
            $error【錯誤詳情】:{{myForm.pattern.$error}}&nbsp;&nbsp;<br>
            5.電子郵件:{{user.email}}
            $pristine 【沒修改】:{{myForm.email.$pristine }}&nbsp;&nbsp;
            $dirty【修改過】:{{myForm.email.$dirty}}&nbsp;&nbsp;
            $invalid【驗證失敗】:{{myForm.email.$invalid}}&nbsp;&nbsp;
            $invalid【驗證成功】:{{myForm.email.$valid}}&nbsp;&nbsp;
            $error【錯誤詳情】:{{myForm.email.$error}}&nbsp;&nbsp;<br>
            6.數字:{{user.age}}
            $pristine 【沒修改】:{{myForm.age.$pristine }}&nbsp;&nbsp;
            $dirty【修改過】:{{myForm.age.$dirty}}&nbsp;&nbsp;
            $invalid【驗證失敗】:{{myForm.age.$invalid}}&nbsp;&nbsp;
            $invalid【驗證成功】:{{myForm.age.$valid}}&nbsp;&nbsp;
            $error【錯誤詳情】:{{myForm.age.$error}}&nbsp;&nbsp;<br>
            7.URL:{{user.url}}
            $pristine 【沒修改】:{{myForm.url.$pristine }}&nbsp;&nbsp;
            $dirty【修改過】:{{myForm.url.$dirty}}&nbsp;&nbsp;
            $invalid【驗證失敗】:{{myForm.url.$invalid}}&nbsp;&nbsp;
            $invalid【驗證成功】:{{myForm.url.$valid}}&nbsp;&nbsp;
            $error【錯誤詳情】:{{myForm.url.$error}}&nbsp;&nbsp;<br>
        </div>
    </body>
</html>
<script type="text/javascript">
    angular.module('myTest', [])
        .controller('myController', function($scope) {
            $scope.submitForm = function(isValid) {
                if (!isValid) {
                    alert('驗證失敗');
                }
            };
        }
        );
</script>
複製代碼

 

效果如下:

同時,ng針對這幾種驗證指令,針對性的設置了一些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-invlid類會被添加到這個字段上。 你可以編輯自己喜歡的CSS . 你可以私有定製化這些類來實現特定的場景應用.

 但是,默認的驗證指令不一定能夠,完全滿足我們的真實應用場景,ng同樣提供的自定義驗證指令的功能。

首先我們來看一個簡單的例子:

複製代碼
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相反。

學習完基礎的知識點, 需要深入學習下自定義驗證的寫法,已經ng1.3之後對驗證指令的易用性有所提高。

 未完待續....

     備註:我也是剛剛開始學習,如果你喜歡本文的話,推薦共勉,謝謝!

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章