詳解Angular Reactive Form 表單驗證
本文我們將介紹 Reactive Form 表單驗證的相關知識,具體內容如下:
- 使用內建的驗證規(guī)則
- 動態(tài)調整驗證規(guī)則
- 自定義驗證器
- 自定義驗證器 (支持參數)
- 跨字段驗證
基礎知識
內建驗證規(guī)則
Angular 提供了一些內建的 validators,我們可以在 Template-Driven 或 Reactive 表單中使用它們。
目前 Angular 支持的內建 validators 如下:
- required - 設置表單控件值是非空的。
- email - 設置表單控件值的格式是 email。
- minlength - 設置表單控件值的最小長度。
- maxlength - 設置表單控件值的最大長度。
- pattern - 設置表單控件的值需匹配 pattern 對應的模式。
示例
this.signupForm = this.fb.group({
userName: ['', [Validators.required, Validators.minLength(3)]],
email: ['', [Validators.required, Validators.pattern('[a-z0-9._%+_]+@[a-z0-9.-]+')]]
});
動態(tài)調整驗證規(guī)則
myControl.setValidators(Validators.required); myControl.setValidators([Validators.required, Validators.maxLength(6)]); myControl.clearValidators(); myControl.updateValueAndValidity();
自定義驗證器
function myCustomValidator(c: AbstractControl):
{[key: string]: boolean} | null {
if(somethingIsWrong) {
return { 'myvalidator': true};
}
return null;
}
自定義驗證器 (支持參數)
function myCustomValidator(param: any): ValidatorFn {
return (c: AbstractControl): {[key: string]: boolean} | null {
if(somethingIsWrong) {
return { 'myvalidator': true};
}
return null;
}
}
跨字段驗證
emailMatcher
function emailMatcher(c: AbstractControl) {
let emailControl = c.get('email');
let confirmControl = c.get('confirmEmail');
if (emailControl.pristine || confirmControl.pristine) {
return null;
}
return emailControl.value === confirmControl.value ? null : { 'match': true };
}
emailGroup
ngOnInit(): void {
this.signupForm = this.fb.group({
userName: ['', [Validators.required, Validators.minLength(6)]],
emailGroup: this.fb.group({
email: ['', [Validators.required, Validators.email]],
confirmEmail: ['', [Validators.required]],
}, { validator: emailMatcher })
});
在介紹表單驗證前,我們來看一下目前頁面的顯示效果:

表單驗證
表單的內建驗證規(guī)則,前面章節(jié)已經介紹過了,接下來我們來介紹在表單中如何 "動態(tài)調整驗證規(guī)則" 。
動態(tài)調整驗證規(guī)則
為了演示 "動態(tài)調整驗證規(guī)則" 的功能,我新增了兩個控件:
- radio - 用于讓用戶設置是否開啟手機登錄。
- tel - 當用戶開啟手機登錄功能,用于讓用戶輸入手機號碼。
當用戶開啟手機登錄功能,手機號碼對應控件的驗證規(guī)則,必須是必填且格式為合法的手機號碼。當用戶不開啟手機登錄功能時,手機號碼對應控件將不是必填的。
新增 radio 控件
<div class="form-group">
<div class="col-md-offset-1 col-md-8 checkbox">
開啟手機登錄
<label>
<input type="radio" value="1"
formControlName="enableMobile">
是
</label>
<label>
<input type="radio" value="0"
formControlName="enableMobile">
否
</label>
</div>
</div>
新增 tel 控件
<div class="form-group"
[ngClass]="{'has-error': (mobile.touched || mobile.dirty) && !mobile.valid }">
<label class="col-md-2 control-label"
for="mobileId">手機號碼</label>
<div class="col-md-8">
<input class="form-control"
id="mobileId"
type="text"
placeholder="請輸入手機號碼"
formControlName="mobile"/>
<span class="help-block" *ngIf="(mobile.touched || mobile.dirty)
&& mobile.errors">
<span *ngIf="mobile.errors.required">
請輸入手機號碼
</span>
<span *ngIf="mobile.errors.minlength">
手機號碼格式不正確
</span>
</span>
</div>
</div>
動態(tài)調整驗證規(guī)則功能
ngOnInit(): void {
...
this.signupForm.get('enableMobile').valueChanges
.subscribe(value => this.checkMobile(value));
}
checkMobile(enableMobile: string): void {
const mobileControl = this.signupForm.get('mobile');
enableMobile === "1" ?
mobileControl.setValidators([Validators.required,
Validators.pattern('1(3|4|5|7|8)\\d{9}')]) :
mobileControl.clearValidators();
mobileControl.updateValueAndValidity();
}
介紹完如何動態(tài)調整驗證規(guī)則,接下來我們來介紹如何 "自定義驗證器"。
自定義驗證器
為了演示 "自定義驗證器" 的功能,我新增了一個控件:
number - 用于讓用戶設置是年齡信息。
當讓用戶手動輸入年齡信息時,我們需要設置一個有效的年齡范圍,比如 (18 - 120)。此時我們就需要通過自定義驗證器來實現上述功能。
新增 number 控件
<div class="form-group"
[ngClass]="{'has-error': (age.touched || age.dirty) && !age.valid }">
<label class="col-md-2 control-label"
for="ageId">年齡</label>
<div class="col-md-8">
<input class="form-control"
id="ageId"
type="number"
placeholder="請輸入年齡"
formControlName="age"/>
<span class="help-block" *ngIf="(age.touched || age.dirty) && age.errors">
<span *ngIf="age.errors.range">
輸入年齡不合法
</span>
</span>
</div>
</div>
自定義驗證器模板
function myCustomValidator(c: AbstractControl):
{[key: string]: boolean} | null {
if(somethingIsWrong) {
return { 'myvalidator': true};
}
return null;
}
新增 ageValidator 驗證器
function ageValidator(c: AbstractControl): { [key: string]: any } | null {
let age = c.value;
if (age && (isNaN(age) || age < 20 || age > 120)) {
return { 'range': true, min: 20, max: 120 };
}
return null;
}
使用 ageValidator 驗證器
ngOnInit(): void {
this.signupForm = this.fb.group({
// ...
age: ['', ageValidator]
});
}
我們的 ageValidator 自定義驗證器,雖然已經實現了。細心的讀者應該會發(fā)現,在 ageValidator 驗證器內部,我們寫死了年齡的邊界值 (最小值與最大值)。理想的情況下,應該能夠讓用戶自行設定邊界值。因此接下來,我們來優(yōu)化一下 ageValidator 驗證器。
自定義驗證器 (支持參數)
自定義驗證器模板 (支持參數)
function myCustomValidator(param: any): ValidatorFn {
return (c: AbstractControl): {[key: string]: boolean} | null {
if(somethingIsWrong) {
return { 'myvalidator': true};
}
return null;
}
}
新增 ageRange 驗證器工廠
function ageRange(min: number, max: number): ValidatorFn {
return (c: AbstractControl): { [key: string]: any } | null => {
let age = c.value;
if (age && (isNaN(age) || age < min || age > max)) {
return { 'range': true, min: min, max: max };
}
return null;
}
}
使用 ageRange 驗證器工廠
ngOnInit(): void {
this.signupForm = this.fb.group({
// ...
age: ['', ageRange(20, 120)]
});
}
介紹完如何自定義驗證器,接下來我們來介紹如何實現 "跨字段驗證" 的功能。
跨字段驗證
在日常生活中,在注冊表單中,經常要讓用戶再次輸入同樣的字段值,比如登錄密碼或郵箱地址的值。針對這種場景,我們就需要驗證兩個控件的輸入值是否一致,這時我們就要引入跨字段驗證的功能。
為了演示 "跨字段驗證" 的功能,我新增了一個控件:
- email - 用于讓用戶確認輸入的郵箱地址
新增 email 控件
<label class="col-md-2 control-label"
for="emailId">確認郵箱</label>
<div class="col-md-8">
<input class="form-control"
id="confirmEmailId"
type="email"
placeholder="請再次輸入郵箱地址"
formControlName="confirmEmail"/>
<span class="help-block" *ngIf="(confirmEmail.touched ||
confirmEmail.dirty)">
<span *ngIf="confirmEmail.errors?.required">
請輸入郵箱地址
</span>
<span *ngIf="!confirmEmail.errors?.required &&
emailGroup.errors?.match">
兩次輸入的郵箱地址不一致
</span>
</span>
</div>
新增 emailMatcher
function emailMatcher(c: AbstractControl) {
let emailControl = c.get('email');
let confirmControl = c.get('confirmEmail');
if (emailControl.pristine || confirmControl.pristine) {
return null;
}
return emailControl.value === confirmControl.value ? null : { 'match': true };
}
新增 emailGroup
ngOnInit(): void {
this.signupForm = this.fb.group({
userName: ['', [Validators.required, Validators.minLength(6)]],
emailGroup: this.fb.group({
email: ['', [Validators.required, Validators.email]],
confirmEmail: ['', [Validators.required]],
}, { validator: emailMatcher }),
// ...
});
更新模板
<div class="form-group"
formGroupName="emailGroup"
[ngClass]="{'has-error': emailGroup.errors }">
<label class="col-md-2 control-label"
for="emailId">郵箱</label>
<div class="col-md-8">
<input class="form-control"
id="emailId"
type="email"
placeholder="請輸入郵箱地址"
formControlName="email"/>
<span class="help-block" *ngIf="(email.touched || email.dirty) &&
email.errors">
<span *ngIf="email.errors.required">
請輸入郵箱地址
</span>
<span *ngIf="!email.errors.required && email.errors.email">
請輸入有效的郵箱地址
</span>
</span>
</div>
<!--其余部分:請參考"新增email控件"的內容-->
</div>
上面代碼中,有以下幾個問題需要注意:
- Form Group 是可以嵌套使用的。
this.signupForm = this.fb.group({
userName: ['', [Validators.required, Validators.minLength(6)]],
emailGroup: this.fb.group({
email: ['', [Validators.required, Validators.email]],
confirmEmail: ['', [Validators.required]],
}, { validator: emailMatcher })
我們通過 formGroupName="groupName" 語法來綁定內嵌的 Form Group。
<div class="form-group" formGroupName="emailGroup"
[ngClass]="{'has-error': emailGroup.errors }">
郵箱不匹配的信息是存在 emailGroup 對象的 errors 屬性中,而不是存在 confirmEmail 對象的 errors 屬性中。
<span *ngIf="!confirmEmail.errors?.required && emailGroup.errors?.match"> 兩次輸入的郵箱地址不一致 </span>
我有話說
怎么會監(jiān)聽表單值的變化?
Reactive Form
export class AppComponent {
constructor(private fb: FormBuilder) {
this.form = fb.group({
name: 'semlinker',
age: 31
});
this.form.valueChanges.subscribe(data => {
console.log('Form changes', data)
});
}
}
Template-driven Form
模板
<form #myForm="ngForm" (ngSubmit)="onSubmit()"> <input type="text" name="name" class="form-control" required [(ngModel)]="user.name"> <input type="number" name="age" class="form-control" required [(ngModel)]="user.age"> </form>
組件類
class AppComponent implements AfterViewInit {
@ViewChild('myForm') form;
ngAfterViewInit() {
this.form.control.valueChanges
.debounceTime(500)
.subscribe(values => this.doSomething(values));
}
}
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持腳本之家。
相關文章
Angular.js項目中使用gulp實現自動化構建以及壓縮打包詳解
基于流的前端自動化構建工具,利用gulp可以提高前端開發(fā)效率,特別是在前后端分離的項目中。下面這篇文章主要給大家介紹了關于在Angular.js項目中使用gulp實現自動化構建以及壓縮打包的相關資料,需要的朋友可以參考下。2017-07-07
Angular 4根據組件名稱動態(tài)創(chuàng)建出組件的方法教程
組件是我們在學習angular中必不可少的一部分,下面這篇文章主要給大家介紹了關于Angular 4如何根據組件名稱動態(tài)創(chuàng)建出組件的相關資料,文中通過圖文與示例代碼介紹的非常詳細,需要的朋友可以參考借鑒,下面來一起看看吧。2017-11-11
div實現自適應高度的textarea實現angular雙向綁定
本文主要介紹了div實現自適應高度的textarea,實現angular雙向綁定的方法。具有一定的參考價值,下面跟著小編一起來看下吧2017-01-01
angular.js4使用 RxJS 處理多個 Http 請求
本篇文章主要介紹了angular.js使用 RxJS 處理多個 Http 請求,小編覺得挺不錯的,現在分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2017-09-09

