開始學習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/"來確保輸入能夠匹配指定的Regex:
複製代碼 代碼如下:
<<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}} $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>
效果如下:
同時,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相反。
以上就是本文的全部內容,希望對大家實現AngularJS表單驗證有所協助。