Angular中Form表單的兩種類型是怎樣的

這篇文章將為大家詳細(xì)講解有關(guān)Angular中Form表單的兩種類型是怎樣的，文章內(nèi)容質(zhì)量較高，因此小編分享給大家做個(gè)參考，希望大家閱讀完這篇文章后對(duì)相關(guān)知識(shí)有一定的了解。

在 Angular 中，表單有兩種類型，分別為模板驅(qū)動(dòng)和模型驅(qū)動(dòng)。

1.  模板驅(qū)動(dòng)

1.1  概述

表單的控制邏輯寫在組件模板中，適合簡(jiǎn)單的表單類型

1.2  快速上手

引入依賴模塊 FormsModule

import { FormsModule } from "@angular/forms"

@NgModule({
  imports: [FormsModule],
})
export class AppModule {}

將 DOM 表單轉(zhuǎn)換為 ngForm

<form #f="ngForm" (submit)="onSubmit(f)"></form>

聲明表單字段為 ngModel

<form #f="ngForm" (submit)="onSubmit(f)">
  <input type="text" name="username" ngModel />
  <button>提交</button>
</form>

獲取表單字段值

import { NgForm } from "@angular/forms"

export class AppComponent {
  onSubmit(form: NgForm) {
    console.log(form.value)
  }
}

表單分組

<form #f="ngForm" (submit)="onSubmit(f)">
  <div ngModelGroup="user">
    <input type="text" name="username" ngModel />
  </div>
  <div ngModelGroup="contact">
    <input type="text" name="phone" ngModel />
  </div>
  <button>提交</button>
</form>

1.3  表單驗(yàn)證

• required 必填字段

• minlength 字段最小長度

• maxlength 字段最大長度

• pattern 驗(yàn)證正則 例如：pattern="\d" 匹配一個(gè)數(shù)值

<form #f="ngForm" (submit)="onSubmit(f)">
  <input type="text" name="username" ngModel required pattern="\d" />
  <button>提交</button>
</form>

export class AppComponent {
  onSubmit(form: NgForm) {
    // 查看表單整體是否驗(yàn)證通過
    console.log(form.valid)
  }
}

<!-- 表單整體未通過驗(yàn)證時(shí)禁用提交表單 -->
<button type="submit" [disabled]="f.invalid">提交</button>

在組件模板中顯示表單項(xiàng)未通過時(shí)的錯(cuò)誤信息

<form #f="ngForm" (submit)="onSubmit(f)">
  <input #username="ngModel" />
  <div *ngIf="username.touched && !username.valid && username.errors">
    <div *ngIf="username.errors.required">請(qǐng)?zhí)顚懹脩裘?lt;/div>
    <div *ngIf="username.errors.pattern">不符合正則規(guī)則</div>
  </div>
</form>

指定表單項(xiàng)未通過驗(yàn)證時(shí)的樣式

input.ng-touched.ng-invalid {
  border: 2px solid red;
}

2.  模型驅(qū)動(dòng)

2.1  概述

表單的控制邏輯寫在組件類中，對(duì)驗(yàn)證邏輯擁有更多的控制權(quán)，適合復(fù)雜的表單的類型。

在模型驅(qū)動(dòng)表單中，表單字段需要是 FormControl 類的實(shí)例，實(shí)例對(duì)象可以驗(yàn)證表單字段中的值，值是否被修改過等等

一組表單字段構(gòu)成整個(gè)表單，整個(gè)表單需要是 FormGroup 類的實(shí)例，它可以對(duì)表單進(jìn)行整體驗(yàn)證

• FormControl：表單組中的一個(gè)表單項(xiàng)

• FormGroup：表單組，表單至少是一個(gè) FormGroup

• FormArray：用于復(fù)雜表單，可以動(dòng)態(tài)添加表單項(xiàng)或表單組，在表單驗(yàn)證時(shí)，FormArray 中有一項(xiàng)沒通過，整體沒通過

2.2  快速上手

引入 ReactiveFormsModule

import { ReactiveFormsModule } from "@angular/forms"

@NgModule({
  imports: [ReactiveFormsModule]
})
export class AppModule {}

在組件類中創(chuàng)建 FormGroup 表單控制對(duì)象

import { FormControl, FormGroup } from "@angular/forms"

export class AppComponent {
  contactForm: FormGroup = new FormGroup({
    name: new FormControl(),
    phone: new FormControl()
  })
}

關(guān)聯(lián)組件模板中的表單

<form [formGroup]="contactForm" (submit)="onSubmit()">
  <input type="text" formControlName="name" />
  <input type="text" formControlName="phone" />
  <button>提交</button>
</form>

獲取表單值

export class AppComponent {
  onSubmit() {
    console.log(this.contactForm.value)
  }
}

設(shè)置表單默認(rèn)值

contactForm: FormGroup = new FormGroup({
  name: new FormControl("默認(rèn)值"),
  phone: new FormControl(15888888888)
})

表單分組

contactForm: FormGroup = new FormGroup({
  fullName: new FormGroup({
    firstName: new FormControl(),
    lastName: new FormControl()
  }),
  phone: new FormControl()
})

<form [formGroup]="contactForm" (submit)="onSubmit()">
  <div formGroupName="fullName">
    <input type="text" formControlName="firstName" />
    <input type="text" formControlName="lastName" />
  </div>
  <input type="text" formControlName="phone" />
  <button>提交</button>
</form>

onSubmit() {
  console.log(this.contactForm.value.name.username)
  console.log(this.contactForm.get(["name", "username"])?.value)
}

2.3   FormArray

需求：在頁面中默認(rèn)顯示一組聯(lián)系方式，通過點(diǎn)擊按鈕可以添加更多聯(lián)系方式組

import { Component, OnInit } from "@angular/core"
import { FormArray, FormControl, FormGroup } from "@angular/forms"
@Component({
  selector: "app-root",
  templateUrl: "./app.component.html",
  styles: []
})
export class AppComponent implements OnInit {
  // 表單
  contactForm: FormGroup = new FormGroup({
    contacts: new FormArray([])
  })

  get contacts() {
    return this.contactForm.get("contacts") as FormArray
  }

  // 添加聯(lián)系方式
  addContact() {
    // 聯(lián)系方式
    const myContact: FormGroup = new FormGroup({
      name: new FormControl(),
      address: new FormControl(),
      phone: new FormControl()
    })
    // 向聯(lián)系方式數(shù)組中添加聯(lián)系方式
    this.contacts.push(myContact)
  }

  // 刪除聯(lián)系方式
  removeContact(i: number) {
    this.contacts.removeAt(i)
  }

  ngOnInit() {
    // 添加默認(rèn)的聯(lián)系方式
    this.addContact()
  }

  onSubmit() {
    console.log(this.contactForm.value)
  }
}

<form [formGroup]="contactForm" (submit)="onSubmit()">
  <div formArrayName="contacts">
    <div
      *ngFor="let contact of contacts.controls; let i = index"
      [formGroupName]="i"
    >
      <input type="text" formControlName="name" />
      <input type="text" formControlName="address" />
      <input type="text" formControlName="phone" />
      <button (click)="removeContact(i)">刪除聯(lián)系方式</button>
    </div>
  </div>
  <button (click)="addContact()">添加聯(lián)系方式</button>
  <button>提交</button>
</form>

2.4  內(nèi)置表單驗(yàn)證器

使用內(nèi)置驗(yàn)證器提供的驗(yàn)證規(guī)則驗(yàn)證表單字段

import { FormControl, FormGroup, Validators } from "@angular/forms"

contactForm: FormGroup = new FormGroup({
  name: new FormControl("默認(rèn)值", [
    Validators.required,
    Validators.minLength(2)
  ])
})

獲取整體表單是否驗(yàn)證通過

onSubmit() {
  console.log(this.contactForm.valid)
}

<!-- 表單整體未驗(yàn)證通過時(shí)禁用表單按鈕 -->
<button [disabled]="contactForm.invalid">提交</button>

在組件模板中顯示為驗(yàn)證通過時(shí)的錯(cuò)誤信息

get name() {
  return this.contactForm.get("name")!
}

<form [formGroup]="contactForm" (submit)="onSubmit()">
  <input type="text" formControlName="name" />
  <div *ngIf="name.touched && name.invalid && name.errors">
    <div *ngIf="name.errors.required">請(qǐng)?zhí)顚懶彰?lt;/div>
    <div *ngIf="name.errors.maxlength">
      姓名長度不能大于
      {{ name.errors.maxlength.requiredLength }} 實(shí)際填寫長度為
      {{ name.errors.maxlength.actualLength }}
    </div>
  </div>
</form>

2.5  自定義同步表單驗(yàn)證器

• 自定義驗(yàn)證器的類型是 TypeScript 類

• 類中包含具體的驗(yàn)證方法，驗(yàn)證方法必須為靜態(tài)方法

• 驗(yàn)證方法有一個(gè)參數(shù) control，類型為 AbstractControl。其實(shí)就是 FormControl 類的實(shí)例對(duì)象的類型

• 如果驗(yàn)證成功，返回 null

• 如果驗(yàn)證失敗，返回對(duì)象，對(duì)象中的屬性即為驗(yàn)證標(biāo)識(shí)，值為 true，標(biāo)識(shí)該項(xiàng)驗(yàn)證失敗

• 驗(yàn)證方法的返回值為 ValidationErrors | null

import { AbstractControl, ValidationErrors } from "@angular/forms"

export class NameValidators {
  // 字段值中不能包含空格
  static cannotContainSpace(control: AbstractControl): ValidationErrors | null {
    // 驗(yàn)證未通過
    if (/\s/.test(control.value)) return { cannotContainSpace: true }
    // 驗(yàn)證通過
    return null
  }
}

import { NameValidators } from "./Name.validators"

contactForm: FormGroup = new FormGroup({
  name: new FormControl("", [
    Validators.required,
    NameValidators.cannotContainSpace
  ])
})

<div *ngIf="name.touched && name.invalid && name.errors">
  <div *ngIf="name.errors.cannotContainSpace">姓名中不能包含空格</div>
</div>

2.6  自定義異步表單驗(yàn)證器

import { AbstractControl, ValidationErrors } from "@angular/forms"

export class NameValidators {
  static shouldBeUnique(control: AbstractControl): Promise<ValidationErrors | null> {
    return new Promise(resolve => {
      if (control.value == "admin") {
         resolve({ shouldBeUnique: true })
       } else {
         resolve(null)
       }
    })
  }
}

contactForm: FormGroup = new FormGroup({
    name: new FormControl(
      "",
      [
        Validators.required
      ],
      NameValidators.shouldBeUnique
    )
 })

<div *ngIf="name.touched && name.invalid && name.errors">
  <div *ngIf="name.errors.shouldBeUnique">用戶名重復(fù)</div>
</div>
<div *ngIf="name.pending">正在檢測(cè)姓名是否重復(fù)</div>

2.7  FormBuilder

創(chuàng)建表單的快捷方式。

• this.fb.control：表單項(xiàng)

• this.fb.group：表單組，表單至少是一個(gè) FormGroup

• this.fb.array：用于復(fù)雜表單，可以動(dòng)態(tài)添加表單項(xiàng)或表單組，在表單驗(yàn)證時(shí)，FormArray 中有一項(xiàng)沒通過，整體沒通過

2.8  練習(xí)

獲取一組復(fù)選框中選中的值

<form [formGroup]="form" (submit)="onSubmit()">
  <label *ngFor="let item of Data">
    <input type="checkbox" [value]="item.value" (change)="onChange($event)" />
    {{ item.name }}
  </label>
  <button>提交</button>
</form>

import { Component } from "@angular/core"
import { FormArray, FormBuilder, FormGroup } from "@angular/forms"
interface Data {
  name: string
  value: string
}
@Component({
  selector: "app-checkbox",
  templateUrl: "./checkbox.component.html",
  styles: []
})
export class CheckboxComponent {
  Data: Array<Data> = [
    { name: "Pear", value: "pear" },
    { name: "Plum", value: "plum" },
    { name: "Kiwi", value: "kiwi" },
    { name: "Apple", value: "apple" },
    { name: "Lime", value: "lime" }
  ]
  form: FormGroup

  constructor(private fb: FormBuilder) {
    this.form = this.fb.group({
      checkArray: this.fb.array([])
    })
  }

  onChange(event: Event) {
    const target = event.target as HTMLInputElement
    const checked = target.checked
    const value = target.value
    const checkArray = this.form.get("checkArray") as FormArray

    if (checked) {
      checkArray.push(this.fb.control(value))
    } else {
      const index = checkArray.controls.findIndex(
        control => control.value === value
      )
      checkArray.removeAt(index)
    }
  }

  onSubmit() {
    console.log(this.form.value)
  }
}

獲取單選框中選中的值

export class AppComponent {
  form: FormGroup

  constructor(public fb: FormBuilder) {
    this.form = this.fb.group({ gender: "" })
  }

  onSubmit() {
    console.log(this.form.value)
  }
}

<form [formGroup]="form" (submit)="onSubmit()">
  <input type="radio" value="male" formControlName="gender" /> Male
  <input type="radio" value="female" formControlName="gender" /> Female
  <button type="submit">Submit</button>
</form>

2.9  其他

• patchValue：設(shè)置表單控件的值（可以設(shè)置全部，也可以設(shè)置其中某一個(gè)，其他不受影響）

• setValue：設(shè)置表單控件的值 (設(shè)置全部，不能排除任何一個(gè))

• valueChanges：當(dāng)表單控件的值發(fā)生變化時(shí)被觸發(fā)的事件

• reset：表單內(nèi)容置空

• updateValueAndValidity：對(duì)指定輸入框 取消校驗(yàn)

validateForm: FormGroup; 

this.validateForm.get('cpwd').updateValueAndValidity();

關(guān)于Angular中Form表單的兩種類型是怎樣的就分享到這里了，希望以上內(nèi)容可以對(duì)大家有一定的幫助，可以學(xué)到更多知識(shí)。如果覺得文章不錯(cuò)，可以把它分享出去讓更多的人看到。