本文demo地址:源碼或最終效果
在項目中,我們有時候往往需要動表單的驗證做動態的規劃。比如在一個註冊界面中同步註冊兩種用户,但兩種用户的輸入項卻不是相同的。
教師的話,要求輸入工號:
學生用户的話,則要求輸入學號:
我們把這種情景,稱為動態的表單驗證。
在上述表中校驗中,我們要求:
- 工號與學號互不干擾。
- 選擇教師類型時,只判斷工號是否已經輸入。
- 選擇學生類型時,則只判斷學號是否已經輸入。
實現方案
其實這個實現的方案有很多種。在項目中我們已經使用過的大體有三種:
- 使用跨字段驗證器。
- 訂閲用户類型,將用户類型發生變化時,重置
工號或學號的驗證規則。 - 訂閲用户類型,將用户類型發生變化時,在
fromGroup中添加或移除工號,學號FromControl。
跨字段驗證器
Anguar的官方給出在在跨字段驗證器的使用示例,該思想是在FromGroup上添加一個驗證器,然後在該驗證器中獲取FormControl的值,在根據具體的情況來進行驗證。
優點:
- 官方示例,學習成本低。
- 直接將驗證放到了驗證器中,邏輯清晰。
- 驗證器不會對獲取
FromGroup的值產生影響。
缺點:
- 無法在
FormControl直接定義驗證條件,不直觀。 - 只能統一顯示錯誤信息,無法為單一的字段定製錯誤信息。
你可以點擊https://segmentfault.com/a/1190000041563611來查看實現樣例。
重置驗證規則
FromControl提供了clearValidators()來清空驗證器,以及setValidators()來設置驗證器,所以我們可以訂閲用户類型是否發生變化,在發生變化時,根據情況清空交叉字段的驗證器,然後再重新對其驗證器進行設置。
優點:
- 為動態地添加異步驗證器提供了一種新的思路
缺點:
- 驗證規則不直觀。
- 代碼量大。
重置FromGroup項
FromGroup提供的removeControl()使得我們可以移除其中的FormControl,利用該機制我們可以訂閲用户類型發生變化後,根據情況來移除、添加相應的FormControl,從而達到動態驗證表單的目的。
示例代碼 C 層:
export class AppComponent implements OnInit {
name = 'Angular ' + VERSION.major;
formGroup = new FormGroup({});
// 學號
studentNoFormControl = new FormControl(null, Validators.required);
// 工號
teachterNoFormControl = new FormControl(null, Validators.required);
// 用户類型
typeFormControl = new FormControl(null, Validators.required);
ngOnInit(): void {
this.formGroup.addControl('name', new FormControl('', Validators.required));
this.formGroup.addControl('type', this.typeFormControl);
// 訂閲類型的變化,從而決定在formGroup中添加學號還是工號FormControl
this.typeFormControl.valueChanges.subscribe((type) => {
if (type === 0) {
this.formGroup.removeControl('studentNo');
this.formGroup.addControl('teacherNo', this.teachterNoFormControl);
} else {
this.formGroup.removeControl('teacherNo');
this.formGroup.addControl('studentNo', this.studentNoFormControl);
}
});
// 初始化用户類型為教師
this.typeFormControl.setValue(0);
}
onSubmit(): void {
alert('submit');
}
/**
* 顯示學號或是工號的input
*/
showStudent(): boolean {
return this.typeFormControl.value === 1;
}
}
V 層:
<hello name="{{ name }}"></hello>
<p>表單動態驗證示例</p>
<pre>{{ formGroup.invalid | json }}</pre>
<pre>{{ formGroup.get('type').value | json }}</pre>
<form [formGroup]="formGroup">
<div>姓名:<input type="text" formControlName="name" /></div>
<div>
用户類型:
<label
><input type="radio" [value]="0" formControlName="type" name="type" />
教師</label
>
<label
><input type="radio" [value]="1" formControlName="type" name="type" />
學生</label
>
</div>
<div *ngIf="showStudent()">
學號:<input type="text" formControlName="studentNo" />
</div>
<div *ngIf="!showStudent()">
工號:<input type="text" formControlName="teacherNo" />
</div>
<button [disabled]="formGroup.invalid" (click)="onSubmit()">Submit</button>
</form>
優點:
- 直接在
FormControl上設置驗證器,代碼直觀。 - 可以直接使用angular提供的ngvalid等class屬性,快速定義校驗結果的樣式。
缺點:
- 驗證器會對獲取
FromGroup的值產生影響。比如在後續對FormGroup獲取相關的值的操作中,需要對FormGroup是否有值來進行判斷,容易產生在undefined上調用value的錯誤。(這可以使用?來規避 ----formGroup.get('xxx')?.value。