上一篇 總結了模版驅動表單的基本用法,示例中的校驗使用的是原生HTML5的校驗方式,本文補上自定義校驗的部分。 HTML5原生的表單校驗屬性(必填,長度限制,取值間隔,正則表達式等等)可以滿足普通的校驗需求,但是有些場景必須用到自定義校驗,比如註冊時的密碼確認,有比對關係的時間/數值選擇, 需要到請 ...
上一篇 總結了模版驅動表單的基本用法,示例中的校驗使用的是原生HTML5的校驗方式,本文補上自定義校驗的部分。
HTML5原生的表單校驗屬性(必填,長度限制,取值間隔,正則表達式等等)可以滿足普通的校驗需求,但是有些場景必須用到自定義校驗,比如註冊時的密碼確認,有比對關係的時間/數值選擇, 需要到請求到服務端取值驗證等等···這裡以密碼確認為例進行說明。
指令開發
表單的驗證狀態是通過 formContro l的 errors 屬性反饋出來的,所以基本的思路肯定就是需要添加校驗規則,然後將驗證結果添加到formControl實例的errors屬性中。那麼問題來了,模版驅動表單的控制都是在HTML模版中完成的,無法直接接觸到 formControl實例。這個時候就需要使用指令了,將檢驗規則進行包裝。Angular提供了 驗證器供應商 NG_VALIDATORS ,用於處理表單自定義校驗。先創建指令。
import { Directive} from '@angular/core'; import { NG_VALIDATORS, Validator, AbstractControl} from '@angular/forms'; @Directive({ selector: '[appConfirmpsw]', providers: [{ provide : NG_VALIDATORS, useExisting : ConfirmpswDirective, multi: true }] }) export class ConfirmpswDirective implements Validator { constructor() { } validate(control: AbstractControl): {[key: string]: any} { //檢驗規則 } }
1、為指令指定供應商 NG_VALIDATORS , 和別名類 ConfirmpswDirective , 及 multi 為true(可以用同一個token,註冊不同的 provide)。因為是在 NG_VALIDATORS 提供商中註冊的指令,所以才能被Angular的驗證流程識別,需要註意的是要用useExisting來註冊,這樣就不會創建一個新的實例。
2、用 Validator介面來約束 自定義的指令,這是Angular提供的驗證器的類 。有validate屬性,會傳入表單的formControl,返回 ValidationErrors 對象。
現在指令結構完成,開始進行校驗部分。首先需要傳入已輸入的密碼,所以增加@input,再指定校驗規則,判斷綁定表單的值和傳入的已輸入值是否相同
@Input('appConfirmpsw') confirmpsw: string;
為了避免使用指令時,還需要額外傳入confirmpsw屬性 ( <input type="password" appConfirmpsw [confirmpsw]="'xxx'" >),所以我們將 指令名稱appConfirmpsw作為confirmpsw的別名,這樣傳值會比較方便,簡化為 <input type="password" [appConfirmpsw] = "'xxx'">。
這裡專門寫一個檢驗函數,用來比對值和返回結果。記得在指令的validate中調用一下
export function comfirmPswValidator(_confirmpsw: string): ValidatorFn { //傳入已輸入的密碼值 , 返回一個ValidatorFn return (control: AbstractControl): {[key: string]: any} => { //傳入綁定表單的formControl if ( !control.value ) { //如果綁定未輸入值,則返回 required錯誤 return { 'required' : true }; }
//如果兩次輸入的值不相同,則返回confirmpsw的錯誤 return control.value !== _confirmpsw ? {'confirmpsw' : {value: true}} : null; }; }
完整指令如下:
import { Directive, Input } from '@angular/core'; import { NG_VALIDATORS, Validator, AbstractControl, ValidatorFn} from '@angular/forms'; @Directive({ selector: '[appConfirmpsw]', providers: [{ provide : NG_VALIDATORS, useExisting : ConfirmpswDirective, multi: true }] }) export class ConfirmpswDirective implements Validator { @Input('appConfirmpsw') confirmpsw: string; constructor() { } validate(control: AbstractControl): {[key: string]: any} { console.log(this.confirmpsw); return this.confirmpsw ? comfirmPswValidator(this.confirmpsw)(control) : null; } } export function comfirmPswValidator(_confirmpsw: string): ValidatorFn { return (control: AbstractControl): {[key: string]: any} => { if ( !control.value ) { return { 'required' : true }; } return control.value !== _confirmpsw ? {'confirmpsw' : {value: true}} : null; }; }
使用
測試一下指令的效果吧
<div class="input-group"> <label class="group-label" for="psw-new"> 新密碼 :</label> <input class="group-input" [(ngModel)]="inputpsw.new" #new="ngModel" type="password" name="psw" id="psw-new" required> </div> <div class="input-group input-error" *ngIf="new.touched&&new.invalid"> <div class="group-error-content" *ngIf="new.errors?.required">確認密碼為必填項!</div> </div> <div class="input-group"> <label class="group-label" for="psw-confirm">確認密碼 :</label> <input class="group-input" [(ngModel)]="inputpsw.confirm" #confirm="ngModel" type="password" name="confirm" id="psw-confirm" [appConfirmpsw] = "new.value" required> </div> <div class="input-group input-error" *ngIf="confirm.touched&&confirm.invalid"> <div class="group-error-content" *ngIf="confirm.errors?.required">新密碼為必填項!</div> <div class="group-error-content" *ngIf="confirm.errors?.confirmpsw">密碼輸入不一致!</div> </div>
傳入new表單的值,並通過errors.confirmpsw屬性來控制提示語反饋。密碼輸入不一致,可以正確的校驗到
確認密碼為空時的提示也正確
以上完成了一個自定義驗證器。有不妥當的地方,望大神指正。