Angular中響應(yīng)式表單的三種更新值方法詳析
前言
眾所周知Angular響應(yīng)式表單相比較模板驅(qū)動表單更大操作性、更易測試性。因此，我更推薦這類表單創(chuàng)造方式。
當(dāng)一個用于修改用戶信息的表單，數(shù)據(jù)的來源總是來自遠程；而對于一個 FormGroup 的創(chuàng)建總在 ngOnInit 中完成。因此，這里會有一個表單更新值的問題。
而通常我們會透過 FormGroup 下的三種方式 setValue、patchValue、reset 將值寫入表單當(dāng)中。
當(dāng)然，或許我說的這三種方式時你壓根就沒有做過，那說明在表單上你依賴的是雙向綁定 [(ngModel)]，這本身就不是符合 Angular 響應(yīng)式表單的牛B之處了。因此，在此我們不討論這種這種方式。下面來一起看看詳細的介紹：
一、創(chuàng)建響應(yīng)式表單
我們模擬一個用戶信息修改的表單所需要的字段，可能包括：email、nickname 等。
如果以API的方式與現(xiàn)實字段之間產(chǎn)生一個關(guān)聯(lián)，那么 FormGroup 表示一個表單，F(xiàn)ormControl 表示表單中的字段。因此，F(xiàn)ormControl 必須包裹在 FromGroup 下面。
下面，我們先簡單的構(gòu)建一個響應(yīng)式表單。
別忘記導(dǎo)入 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
}
}
以上的這些代碼再熟悉不過了。假設(shè) UserEditComponent 是由路由 /user/edit/1 觸發(fā)，那么會發(fā)生幾個幾件事情。
首先，創(chuàng)建一個空的響應(yīng)式表單 form。
this.form = this.fb.group({
email: ['', Validators.compose([Validators.required, Validators.email])],
nickname: ['', [Validators.required]]
});
表單的內(nèi)容有 email、nickname 兩個字段。
- email 必填項且必須是標(biāo)準(zhǔn) Email 格式。
- nickname 必填項。
然而，HTML中，除了 formGroup、formControlName 的配置以外，也看不到任何有關(guān)對表單的校驗代碼。但，當(dāng)我們輸入一個無效 Email 時 input 會自動加上 ng-invalid 類。
這便是響應(yīng)式表單的魅力。
現(xiàn)在我們回到正題，將分別針對 setValue、patchValue、reset 三種不同更新表單值實際上會發(fā)生什么。
二、patchValue
正如名稱那般，打補丁。假如我們在 email 文本框里輸入：xx@xx.com，接著調(diào)用：
this.form.patchValue({ nickname: 'cipchk' });
最終的結(jié)果是兩個字段同時擁有值，因為這里我們只對 nickname 設(shè)置了值，而 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 查找主鍵，并以主鍵名查找相應(yīng)的 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 相當(dāng)于表單實際值，還記得先前HTML中的 formControlName 就是將實例與DOM產(chǎn)生聯(lián)系，這也就是為什么不需要在DOM中使用雙向綁定的原因。
三、setValue
跟 patchValue 有一點不一樣，當(dāng)我們提供一個 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); 當(dāng)傳遞的對象有一個不是 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);
}
除了恢復(fù)校驗狀態(tài)以外。最后一句代碼是調(diào)用 setValue，這等同上一節(jié)說的。因此，當(dāng)我們調(diào)用此方法時，允許我們直接傳遞一個數(shù)據(jù)對象做為重置后的默認值，比如：
<button (click)="form.reset({ nickname: 'xx' })">Reset</button>
重置表單后并設(shè)置 nickname 默認值為：xx。
結(jié)論
每一種不同更新值方式都會有不一樣的結(jié)果，當(dāng)我們回頭過看開頭中留下來的：
// Updating value
如果是你，你會怎么寫呢？
總結(jié)
以上就是這篇文章的全部內(nèi)容了，希望本文的內(nèi)容對大家的學(xué)習(xí)或者工作能帶來一定的幫助，如果有疑問大家可以留言交流，謝謝大家對腳本之家的支持。
相關(guān)文章
這篇文章主要給大家介紹了關(guān)于如何利用Angular7開發(fā)一個Radio組件的相關(guān)資料，文中通過示例代碼介紹的非常詳細，對大家學(xué)習(xí)或者使用Angular7具有一定的參考學(xué)習(xí)價值，需要的朋友們下面來一起學(xué)習(xí)學(xué)習(xí)吧2019-07-07
簡單來說Angular.js是google開發(fā)者設(shè)計和開發(fā)的一套前端開發(fā)框架，幫助你簡化前端開發(fā)的負擔(dān)。當(dāng)然，這里有很多其它的前端開發(fā)框架，但是如何選擇合適的前端框架對于我們這些開發(fā)人員來說就不是那么容易了！2014-11-11
Angular2學(xué)習(xí)教程之組件中的DOM操作詳解
這篇文章主要給大家介紹了Angular2學(xué)習(xí)教程之組件中DOM操作的相關(guān)資料，文中介紹的非常詳細，對大家具有一定的參考學(xué)習(xí)價值，需要的朋友們下面跟著小編一起來看看吧。2017-05-05
下面小編就為大家?guī)硪黄狝ngularJS 表單驗證手機號的實例(非必填)。小編覺得挺不錯的，現(xiàn)在就分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2017-11-11
Angular懶加載動態(tài)創(chuàng)建顯示該模塊下聲明的組件
這篇文章主要為大家介紹了Angular懶加載動態(tài)創(chuàng)建顯示該模塊下聲明的組件，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪2022-05-05
這篇文章主要給大家介紹了關(guān)于Angular2使用jQuery的方法教程，文中介紹的非常詳細，對大家具有一定的參考學(xué)習(xí)價值，需要的朋友們下面來跟著小編一起學(xué)習(xí)學(xué)習(xí)吧。2017-05-05
angularjs創(chuàng)建彈出框?qū)崿F(xiàn)拖動效果
這篇文章主要為大家詳細介紹了angularjs創(chuàng)建彈出框?qū)崿F(xiàn)拖動效果的相關(guān)資料，angularjs modal模態(tài)框創(chuàng)建可拖動的指令，感興趣的小伙伴們可以參考一下2016-01-01
angularJs提交文本框數(shù)據(jù)到后臺的方法
今天小編就為大家分享一篇angularJs提交文本框數(shù)據(jù)到后臺的方法，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2018-10-10
這篇文章主要介紹了Angular中的interceptors攔截器,需要的朋友可以參考下2017-06-06
angular.JS實現(xiàn)網(wǎng)頁禁用調(diào)試、復(fù)制和剪切
這篇文章主要給大家介紹了angular.JS實現(xiàn)網(wǎng)頁禁用調(diào)試、復(fù)制和剪切的相關(guān)資料，文中介紹的非常詳細，相信對大家具有一定的參考價值，需要的朋友們下面來一起看看吧。2017-03-03