麻麻让我挺进她的黑森林,挺进刘亦菲的滋润花苞,夜夜春夜夜爽

Angular 4.x 中有兩種表單：

Template-Driven Forms - 模板驅動式表單 (類似于 Angular 1.x 中的表單 )
Reactive Forms (Model-Driven Forms) - 響應式表單

Template-Driven Forms (模板驅動表單) ，我們之前的文章已經介紹過了，了解詳細信息，請查看 - Angular 4 Template-Driven Forms 。

ngModule and reactive forms
FormControl and FormGroup
Implementing our FormGroup model
Binding our FormGroup model
Reactive submit
Reactive error validation
Simplifying with FormBuilder

Form base and interface

Form base

<form novalidate>
  <label>
    <span>Full name</span>
    <input
      type="text"
      name="name"
      placeholder="Your full name">
  </label>
  <div>
    <label>
      <span>Email address</span>
      <input
        type="email"
        name="email"
        placeholder="Your email address">
    </label>
    <label>
      <span>Confirm address</span>
      <input
        type="email"
        name="confirm"
        placeholder="Confirm your email address">
    </label>
  </div>
  <button type="submit">Sign up</button>
</form>

接下來我們要實現的功能如下：

綁定 name、email、confirm 輸入框的值
為所有輸入框添加表單驗證功能
顯示驗證異常信息
表單驗證失敗時，不允許進行表單提交
表單提交功能

User interface

// signup.interface.ts
export interface User {
  name: string;
  account: {
    email: string;
    confirm: string;
  }
}

ngModule and reactive forms

在我們繼續深入介紹 reactive forms 表單前，我們必須在 @NgModule 中導入 @angular/forms 庫中的 ReactiveFormsModule：

import { ReactiveFormsModule } from '@angular/forms';

@NgModule({
  imports: [
    ...,
    ReactiveFormsModule
  ],
  declarations: [...],
  bootstrap: [...]
})
export class AppModule {}

友情提示：若使用 reactive forms，則導入 ReactiveFormsModule；若使用 template-driven 表單，則導入 FormsModule。

Reactive approach

我們將基于上面的定義的基礎表單，創建 SignupFormComponent ：

signup-form.component.ts

import { Component } from '@angular/core';

@Component({
  selector: 'signup-form',
  template: `
    <form novalidate>...</form>
  `
})
export class SignupFormComponent {
  constructor() {}
}

這是一個基礎的組件，在我們實現上述功能前，我們需要先介紹 FormControl、FormGroup、FormBuilder 的概念和使用。

FormControl and FormGroup

我們先來介紹一下 FormControl 和 FormGroup 的概念：

FormControl - 它是一個為單個表單控件提供支持的類，可用于跟蹤控件的值和驗證狀態，此外還提供了一系列公共API。

使用示例：

ngOnInit() {
  this.myControl = new FormControl('Semlinker');
}

FormGroup - 包含是一組 FormControl 實例，可用于跟蹤 FormControl 組的值和驗證狀態，此外也提供了一系列公共API。

使用示例：

ngOnInit() {
  this.myGroup = new FormGroup({
    name: new FormControl('Semlinker'),
    location: new FormControl('China, CN')
  });
}

現在我們已經創建了 FormControl 和 FormGroup 實例，接下來我們來看一下如何使用：

<form novalidate [formGroup]="myGroup">
  Name: <input type="text" formControlName="name">
  Location: <input type="text" formControlName="location">
</form>

注意事項：Template-Driven Forms 中介紹的 ngModel 和 name="" 屬性，已經被移除了。這是一件好事，讓我們的模板更簡潔。

上面示例中，我們必須使用 [formGroup] 綁定我們創建的 myGroup 對象，除此之外還要使用 formControlName 指令，綁定我們創建的 FormControl 控件。此時的表單結構如下：

FormGroup -> 'myGroup'
    FormControl -> 'name'
    FormControl -> 'location'

Implementing our FormGroup model

signup.interface.ts

export interface User {
  name: string;
  account: {
    email: string;
    confirm: string;
  }
}

與之對應的表單結構如下：

FormGroup -> 'user'
    FormControl -> 'name'
    FormGroup -> 'account'
        FormControl -> 'email'
        FormControl -> 'confirm'

是的，我們可以創建嵌套的 FormGroup 集合！讓我們更新一下組件 (不包含初始數據)：

import { Component, OnInit } from '@angular/core';
import { FormControl, FormGroup } from '@angular/forms';

@Component({...})
export class SignupFormComponent implements OnInit {
  user: FormGroup;
  ngOnInit() {
    this.user = new FormGroup({
      name: new FormControl(''),
      account: new FormGroup({
        email: new FormControl(''),
        confirm: new FormControl('')
      })
    });
  }
}

如果我們想要設置初始數據，我們可以按照上述示例進行設置。通常情況下，我們通過服務端提供的 API 接口來獲取表單的初始信息。

Binding our FormGroup model

現在我們已經實例化了 FormGroup 模型，是時候綁定到對應的 DOM 元素上了。具體示例如下：

<form novalidate [formGroup]="user">
  <label>
    <span>Full name</span>
    <input
      type="text"
      placeholder="Your full name"
      formControlName="name">
  </label>
  <div formGroupName="account">
    <label>
      <span>Email address</span>
      <input
        type="email"
        placeholder="Your email address"
        formControlName="email">
    </label>
    <label>
      <span>Confirm address</span>
      <input
        type="email"
        placeholder="Confirm your email address"
        formControlName="confirm">
    </label>
  </div>
  <button type="submit">Sign up</button>
</form>

現在 FormGroup 與 FormControl 對象與 DOM 結構的關聯信息如下：

// JavaScript APIs
FormGroup -> 'user'
    FormControl -> 'name'
    FormGroup -> 'account'
        FormControl -> 'email'
        FormControl -> 'confirm'

// DOM bindings
formGroup -> 'user'
    formControlName -> 'name'
    formGroupName -> 'account'
        formControlName -> 'email'
        formControlName -> 'confirm'

當使用模板驅動的表單時，為了獲取 f.value 表單的值，我們需要先執行 #f="ngForm" 的操作。而對于使用響應式的表單，我們可以通過以下方式，方便的獲取表單的值：

{{ user.value | json }} // { name: '', account: { email: '', confirm: '' }}

Reactive submit

跟模板驅動的表單一樣，我們可以通過 ngSubmit 輸出屬性，處理表單的提交邏輯：

<form novalidate (ngSubmit)="onSubmit(user)" [formGroup]="user">
  ...
</form>

需要注意的是，我們使用 user 對象作為 onSubmit() 方法的參數，這使得我們可以獲取表單對象的相關信息，具體處理邏輯如下：

export class SignupFormComponent {
  user: FormGroup;
  onSubmit({ value, valid }: { value: User, valid: boolean }) {
    console.log(value, valid);
  }
}

上面代碼中，我們使用 Object destructuring (對象解構) 的方式，從user 對象中獲取 value 和 valid 屬性的值。其中 value 的值，就是 user.value 的值。在實際應用中，我們是不需要傳遞 user 參數的：

export class SignupFormComponent {
  user: FormGroup;
  onSubmit() {
    console.log(this.user.value, this.user.valid);
  }
}

表單的數據綁定方式和提交邏輯已經介紹完了，是該介紹表單實際應用中，一個重要的環節 — 表單驗證。

Reactive error validation

接下來我們來為表單添加驗證規則，首先我們需要從 @angular/forms 中導入 Validators。具體使用示例如下：

ngOnInit() {
  this.user = new FormGroup({
    name: new FormControl('', [Validators.required, Validators.minLength(2)]),
    account: new FormGroup({
      email: new FormControl('', Validators.required),
      confirm: new FormControl('', Validators.required)
    })
  });
}

通過以上示例，我們可以看出，如果表單控制包含多種驗證規則，可以使用數組聲明多種驗證規則。若只包含一種驗證規則，直接聲明就好。通過這種方式，我們就不需要在模板的輸入控件中添加 required 屬性。接下來我們來添加表單驗證失敗時，不允許進行表單提交功能：

<form novalidate (ngSubmit)="onSubmit(user)" [formGroup]="user">
  ...
  <button type="submit" [disabled]="user.invalid">Sign up</button>
</form>

那么問題來了，我們要如何獲取表單控件的驗證信息？我們可以使用模板驅動表單中介紹的方式，具體如下：

<form novalidate [formGroup]="user">
  {{ user.controls.name?.errors | json }}
</form>

友情提示：?.prop 稱為安全導航操作符，用于告訴 Angular prop 的值可能不存在。

此外我們也可以使用 FormGroup 對象提供的 API，來獲取表單控件驗證的錯誤信息：

<form novalidate [formGroup]="user">
  {{ user.get('name').errors | json }}
</form>

現在我們來看一下完整的代碼：

import { Component, OnInit } from '@angular/core';
import { FormControl, FormGroup, Validators } from '@angular/forms';
import { User } from './signup.interface';

@Component({
  selector: 'signup-form',
  template: `
    <form novalidate (ngSubmit)="onSubmit(user)" [formGroup]="user">
      <label>
        <span>Full name</span>
        <input type="text" placeholder="Your full name" formControlName="name">
      </label>
      <div class="error" *ngIf="user.get('name').hasError('required') && 
            user.get('name').touched">
        Name is required
      </div>
      <div class="error" *ngIf="user.get('name').hasError('minlength') && 
            user.get('name').touched">
        Minimum of 2 characters
      </div>
      <div formGroupName="account">
        <label>
          <span>Email address</span>
          <input type="email" placeholder="Your email address" formControlName="email">
        </label>
        <div
          class="error"
          *ngIf="user.get('account').get('email').hasError('required') && 
             user.get('account').get('email').touched">
          Email is required
        </div>
        <label>
          <span>Confirm address</span>
          <input type="email" placeholder="Confirm your email address" 
             formControlName="confirm">
        </label>
        <div
          class="error"
          *ngIf="user.get('account').get('confirm').hasError('required') && 
             user.get('account').get('confirm').touched">
          Confirming email is required
        </div>
      </div>
      <button type="submit" [disabled]="user.invalid">Sign up</button>
    </form>
  `
})
export class SignupFormComponent implements OnInit {
  user: FormGroup;
  constructor() {}
  ngOnInit() {
    this.user = new FormGroup({
      name: new FormControl('', [Validators.required, Validators.minLength(2)]),
      account: new FormGroup({
        email: new FormControl('', Validators.required),
        confirm: new FormControl('', Validators.required)
      })
    });
  }
  onSubmit({ value, valid }: { value: User, valid: boolean }) {
    console.log(value, valid);
  }
}

功能是實現了，但創建 FormGroup 對象的方式有點繁瑣，Angular 團隊也意識到這點，因此為我們提供 FormBuilder ，來簡化上面的操作。

Simplifying with FormBuilder

首先我們需要從 @angular/forms 中導入 FormBuilder：

import { FormBuilder, FormGroup, Validators } from '@angular/forms';

export class SignupFormComponent implements OnInit {
  user: FormGroup;
  constructor(private fb: FormBuilder) {}
  ...
}

然后我們使用 FormBuilder 對象提供的 group() 方法，來創建 FormGroup 和 FormControl 對象：

調整前的代碼 (未使用FormBuilder)：

ngOnInit() {
  this.user = new FormGroup({
    name: new FormControl('', [Validators.required, Validators.minLength(2)]),
    account: new FormGroup({
      email: new FormControl('', Validators.required),
      confirm: new FormControl('', Validators.required)
    })
  });
}

調整后的代碼 (使用FormBuilder)：

ngOnInit() {
  this.user = this.fb.group({
    name: ['', [Validators.required, Validators.minLength(2)]],
    account: this.fb.group({
      email: ['', Validators.required],
      confirm: ['', Validators.required]
    })
  });
}

對比一下調整前和調整后的代碼，是不是感覺一下子方便了許多。此時更新完后完整的代碼如下：

@Component({...})
export class SignupFormComponent implements OnInit {
  user: FormGroup;
  constructor(private fb: FormBuilder) {}
  ngOnInit() {
    this.user = this.fb.group({
      name: ['', [Validators.required, Validators.minLength(2)]],
      account: this.fb.group({
        email: ['', Validators.required],
        confirm: ['', Validators.required]
      })
    });
  }
  onSubmit({ value, valid }: { value: User, valid: boolean }) {
    console.log(value, valid);
  }
}

我有話說

Template-Driven Forms vs Reactive Forms

Template-Driven Forms (模板驅動表單) 的特點

使用方便
適用于簡單的場景
通過 [(ngModel)] 實現數據雙向綁定
最小化組件類的代碼
不易于單元測試

Reactive Forms (響應式表單) 的特點

比較靈活
適用于復雜的場景
簡化了HTML模板的代碼，把驗證邏輯抽離到組件類中
方便的跟蹤表單控件值的變化
易于單元測試

參考資源

Angular 2 form fundamentals: reactive forms

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美国产综合欧美视频

Angular 4 Reactive Forms

Angular 4 Reactive Forms

Contents

Form base and interface

Form base

User interface

ngModule and reactive forms

Reactive approach

FormControl and FormGroup

Implementing our FormGroup model

Binding our FormGroup model

Reactive submit

Reactive error validation

Simplifying with FormBuilder

我有話說

Template-Driven Forms vs Reactive Forms

Template-Driven Forms (模板驅動表單) 的特點

Reactive Forms (響應式表單) 的特點

參考資源

推薦閱讀更多精彩內容

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美 国产 综合 欧美 视频

Angular 4 Reactive Forms

Contents

Form base and interface

Form base

User interface

ngModule and reactive forms

Reactive approach

FormControl and FormGroup

Implementing our FormGroup model

Binding our FormGroup model

Reactive submit

Reactive error validation

Simplifying with FormBuilder

我有話說

Template-Driven Forms vs Reactive Forms

Template-Driven Forms (模板驅動表單) 的特點

Reactive Forms (響應式表單) 的特點

參考資源

推薦閱讀更多精彩內容

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美国产综合欧美视频