Angular中響應式表單的三種更新值方法詳析

發(fā)布時間：2020-09-25 12:02:17 來源：腳本之家閱讀：234 作者：cipchk 欄目：web開發(fā)

前言

眾所周知Angular響應式表單相比較模板驅(qū)動表單更大操作性、更易測試性。因此，我更推薦這類表單創(chuàng)造方式。

當一個用于修改用戶信息的表單，數(shù)據(jù)的來源總是來自遠程；而對于一個 FormGroup 的創(chuàng)建總在 ngOnInit 中完成。因此，這里會有一個表單更新值的問題。

而通常我們會透過 FormGroup 下的三種方式 setValue、patchValue、reset 將值寫入表單當中。

當然，或許我說的這三種方式時你壓根就沒有做過，那說明在表單上你依賴的是雙向綁定 [(ngModel)]，這本身就不是符合 Angular 響應式表單的牛B之處了。因此，在此我們不討論這種這種方式。下面來一起看看詳細的介紹：

一、創(chuàng)建響應式表單

我們模擬一個用戶信息修改的表單所需要的字段，可能包括：email、nickname 等。

如果以API的方式與現(xiàn)實字段之間產(chǎn)生一個關聯(lián)，那么 FormGroup 表示一個表單，F(xiàn)ormControl 表示表單中的字段。因此，F(xiàn)ormControl 必須包裹在 FromGroup 下面。

下面，我們先簡單的構(gòu)建一個響應式表單。

別忘記導入 ReactiveFormsModule 模塊。

@Component({
 selector: 'app-validation',
 template: `
 <form [formGroup]="form" (ngSubmit)="_submitForm(form)">
 <input type="email" formControlName="email">
 <input type="text" formControlName="nickname">
 <button type="submit" [disabled]="form.invalid">Submit</button>
 </form>
 `
})
export class UserEditComponent {
 constructor(private fb: FormBuilder, private route: ActivatedRoute) {}
 
 ngOnInit() {
 this.form = this.fb.group({
  email: ['', Validators.compose([Validators.required, Validators.email])],
  nickname: ['', [Validators.required]]
 });
 
 this.route.params
  .switchMap((params: Params) => loadUser(+params['id']))
  .subscribe(data => {
  // Updating value
  });
 }
 
 loadUser() {
 return Observable.of({ email: 'xx@xx.com', nickname: 'cipchk' }).delay(1000);
 }
 
 _submitForm({ value }) {
 // Save value
 }
}

以上的這些代碼再熟悉不過了。假設 UserEditComponent 是由路由 /user/edit/1 觸發(fā)，那么會發(fā)生幾個幾件事情。

首先，創(chuàng)建一個空的響應式表單 form。

this.form = this.fb.group({
 email: ['', Validators.compose([Validators.required, Validators.email])],
 nickname: ['', [Validators.required]]
});

表單的內(nèi)容有 email、nickname 兩個字段。

email 必填項且必須是標準 Email 格式。
nickname 必填項。

然而，HTML中，除了 formGroup、formControlName 的配置以外，也看不到任何有關對表單的校驗代碼。但，當我們輸入一個無效 Email 時 input 會自動加上 ng-invalid 類。

這便是響應式表單的魅力。

現(xiàn)在我們回到正題，將分別針對 setValue、patchValue、reset 三種不同更新表單值實際上會發(fā)生什么。

二、patchValue

正如名稱那般，打補丁。假如我們在 email 文本框里輸入：xx@xx.com，接著調(diào)用：

this.form.patchValue({ nickname: 'cipchk' });

最終的結(jié)果是兩個字段同時擁有值，因為這里我們只對 nickname 設置了值，而 email 并沒有，那只是先前人為錄入的數(shù)據(jù)。

那么 patchValue 實際上做了什么呢？

patchValue(value: {[key: string]: any}, options: {onlySelf?: boolean, emitEvent?: boolean} = {}): void {
 Object.keys(value).forEach(name => {
 if (this.controls[name]) {
 this.controls[name].patchValue(value[name], {onlySelf: true, emitEvent: options.emitEvent});
 }
 });
 this.updateValueAndValidity(options);
}

首先，利用 Object.keys 查找主鍵，并以主鍵名查找相應的 FromControl 實例對象：

Object.keys({ nickname: 'cipchk' }).forEach(name => { 
 console.log(name); 
});
// [ 'nickname' ]

然后，更新值：

this.controls[name].patchValue(value[name], {onlySelf: true, emitEvent: options.emitEvent});

而 FromControl 實例的 patchValue 和 FromGroup 不同，他只是單純的更新 FromControle 實例對象中的 value 值。

value 相當于表單實際值，還記得先前HTML中的 formControlName 就是將實例與DOM產(chǎn)生聯(lián)系，這也就是為什么不需要在DOM中使用雙向綁定的原因。

三、setValue

跟 patchValue 有一點不一樣，當我們提供一個 FromGroup 中并不存在的字段時，會拋出一個錯誤。除此之外，與 patchValue 并無不同。

setValue(value: {[key: string]: any}, options: {onlySelf?: boolean, emitEvent?: boolean} = {}): void {
 this._checkAllValuesPresent(value);
 Object.keys(value).forEach(name => {
 this._throwIfControlMissing(name);
 this.controls[name].setValue(value[name], {onlySelf: true, emitEvent: options.emitEvent});
 });
 this.updateValueAndValidity(options);
}

主要是 this._throwIfControlMissing(name); 當傳遞的對象有一個不是 FromControl 時直接拋棄一個 Error。

_throwIfControlMissing(name: string): void {
 if (!Object.keys(this.controls).length) {
 throw new Error(`
 There are no form controls registered with this group yet. If you're using ngModel,
 you may want to check next tick (e.g. use setTimeout).
 `);
 }
 if (!this.controls[name]) {
 throw new Error(`Cannot find form control with name: ${name}.`);
 }
}

四、reset

正常情況下，表單需要提供一個重置按鈕時調(diào)用此方法。

reset(formState: any = null, options: {onlySelf?: boolean, emitEvent?: boolean} = {}): void {
 this._applyFormState(formState);
 this.markAsPristine(options);
 this.markAsUntouched(options);
 this.setValue(this._value, options);
}

除了恢復校驗狀態(tài)以外。最后一句代碼是調(diào)用 setValue，這等同上一節(jié)說的。因此，當我們調(diào)用此方法時，允許我們直接傳遞一個數(shù)據(jù)對象做為重置后的默認值，比如：

<button (click)="form.reset({ nickname: 'xx' })">Reset</button>

重置表單后并設置 nickname 默認值為：xx。

結(jié)論

每一種不同更新值方式都會有不一樣的結(jié)果，當我們回頭過看開頭中留下來的：

// Updating value

如果是你，你會怎么寫呢？

總結(jié)

以上就是這篇文章的全部內(nèi)容了，希望本文的內(nèi)容對大家的學習或者工作能帶來一定的幫助，如果有疑問大家可以留言交流，謝謝大家對億速云的支持。

向AI問一下細節(jié)

Angular中響應式表單的三種更新值方法詳析

猜你喜歡

最新資訊

相關推薦

相關標簽