下载APP 编程狮,随时随地学编程
返回 首页

Angular9 中文教程

Angular9 表单简介

用表单处理用户输入是许多常见应用的基础功能。 应用通过表单来让用户登录、修改个人档案、输入敏感信息以及执行各种数据输入任务。

Angular 提供了两种不同的方法来通过表单处理用户输入:响应式表单和模板驱动表单。 两者都从视图中捕获用户输入事件、验证用户输入、创建表单模型、修改数据模型,并提供跟踪这些更改的途径。

本指南提供的信息可以帮你确定哪种方式最适合你的情况。它介绍了这两种方法所用的公共构造块,还总结了两种方式之间的关键区别,并在建立、数据流和测试等不同的情境下展示了这些差异。

先决条件

要想学习使用表单,你应该对这些内容有基本的了解:

  • TypeScript和 HTML5 编程。

  • Angular 的应用设计基础,就像Angular Concepts 中描述的那样。

  • Angular 模板语法的基础知识。

选择一种方法

响应式表单和模板驱动表单以不同的方式处理和管理表单数据。每种方法都有各自的优点。

  • 响应式表单提供对底层表单对象模型直接、显式的访问。它们与模板驱动表单相比,更加健壮:它们的可扩展性、可复用性和可测试性都更高。如果表单是你的应用程序的关键部分,或者你已经在使用响应式表单来构建应用,那就使用响应式表单。

  • 模板驱动表单依赖模板中的指令来创建和操作底层的对象模型。它们对于向应用添加一个简单的表单非常有用,比如电子邮件列表注册表单。它们很容易添加到应用中,但在扩展性方面不如响应式表单。如果你有可以只在模板中管理的非常基本的表单需求和逻辑,那么模板驱动表单就很合适。

关键差异

下表总结了响应式表单和模板驱动表单之间的一些关键差异。

响应式 模板驱动
建立表单模型 显式的,在组件类中创建 隐式的,由指令创建
数据模型 结构化和不可变的 非结构化和可变的
可预测性 同步 异步
表单验证 函数 指令

可伸缩性

如果表单是应用程序的核心部分,那么可伸缩性就非常重要。能够跨组件复用表单模型是至关重要的。

响应式表单比模板驱动表单更有可伸缩性。它们提供对底层表单 API 的直接访问,以及对表单数据模型的同步访问,从而可以更轻松地创建大型表单。响应式表单需要较少的测试设置,测试时不需要深入理解变更检测,就能正确测试表单更新和验证。

模板驱动表单专注于简单的场景,可复用性没那么高。它们抽象出了底层表单 API,并且只提供对表单数据模型的异步访问。对模板驱动表单的这种抽象也会影响测试。测试程序非常依赖于手动触发变更检测才能正常运行,并且需要进行更多设置工作。

建立表单模型

响应式表单和模板驱动型表单都会跟踪用户与之交互的表单输入元素和组件模型中的表单数据之间的值变更。这两种方法共享同一套底层构建块,只在如何创建和管理常用表单控件实例方面有所不同。


常用表单基础类

响应式表单和模板驱动表单都建立在下列基础类之上。

  • FormControl 实例用于追踪单个表单控件的值和验证状态。

  • FormGroup 用于追踪一个表单控件组的值和状态。

  • FormArray 用于追踪表单控件数组的值和状态。

  • ControlValueAccessor 用于在 Angular 的 FormControl 实例和原生 DOM 元素之间创建一个桥梁。

建立响应式表单

对于响应式表单,你可以直接在组件类中定义表单模型。[formControl] 指令会通过内部值访问器来把显式创建的 FormControl 实例与视图中的特定表单元素联系起来。

下面的组件使用响应式表单为单个控件实现了一个输入字段。在这个例子中,表单模型是 FormControl 实例。

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

@Component({
  selector: 'app-reactive-favorite-color',
  template: `
    Favorite Color: <input type="text" [formControl]="favoriteColorControl">
  `
})
export class FavoriteColorComponent {
  favoriteColorControl = new FormControl('');
}

下图展示了在响应式表单中直接访问表单模型。它通过输入元素上的 [formControl] 指令,在任何给定的时间点提供表单元素的值和状态。


建立模板驱动表单

在模板驱动表单中,表单模型是隐式的,而不是显式的。指令 NgModel 为指定的表单元素创建并管理一个 FormControl 实例。

下面的组件使用模板驱动表单为单个控件实现了同样的输入字段。

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

@Component({
  selector: 'app-template-favorite-color',
  template: `
    Favorite Color: <input type="text" [(ngModel)]="favoriteColor">
  `
})
export class FavoriteColorComponent {
  favoriteColor = '';
}

在模板驱动表单中,对表单模型的间接访问。你没有对 FormControl 实例的直接编程访问,如下图所示。

表单中的数据流

当应用包含一个表单时,Angular 必须让该视图与组件模型保持同步,并让组件模型与视图保持同步。当用户通过视图更改值并进行选择时,新值必须反映在数据模型中。同样,当程序逻辑改变数据模型中的值时,这些值也必须反映到视图中。

响应式表单和模板驱动表单在处理来自用户或程序化变更时的数据处理方式上有所不同。下面的这些示意图会以上面定义的 favorite-color 输入字段为例,分别说明两种表单各自的数据流。


响应式表单中的数据流

在响应式表单中,视图中的每个表单元素都直接链接到一个表单模型(FormControl 实例)。 从视图到模型的修改以及从模型到视图的修改都是同步的,而且不依赖于 UI 的渲染方式。

这个视图到模型的示意图展示了当输入字段的值发生变化时数据是如何从视图开始,经过下列步骤进行流动的。

  1. 最终用户在输入框元素中键入了一个值,这里是 "Blue"。

  2. 这个输入框元素会发出一个带有最新值的 "input" 事件。

  3. 这个控件值访问器 ControlValueAccessor 会监听表单输入框元素上的事件,并立即把新值传给 FormControl 实例。

  4. FormControl 实例会通过 valueChanges 这个可观察对象发出这个新值。

  5. valueChanges 的任何一个订阅者都会收到这个新值。

这个模型到视图的示意图体现了程序中对模型的修改是如何通过下列步骤传播到视图中的。

  1. favoriteColorControl.setValue() 方法被调用,它会更新这个 FormControl 的值。

  2. FormControl 实例会通过 valueChanges 这个可观察对象发出新值。

  3. valueChanges 的任何订阅者都会收到这个新值。

  4. 该表单输入框元素上的控件值访问器会把控件更新为这个新值。


模板驱动表单中的数据流

在模板驱动表单中,每一个表单元素都是和一个负责管理内部表单模型的指令关联起来的。

这个视图到模型的图表展示了当输入字段的值发生变化时,数据流是如何从视图开始经过下列步骤进行流动的。

  1. 最终用户在输入框元素中敲 "Blue"。

  2. 该输入框元素会发出一个 "input" 事件,带着值 "Blue"。

  3. 附着在该输入框上的控件值访问器会触发 FormControl 实例上的 setValue() 方法。

  4. FormControl 实例通过 valueChanges 这个可观察对象发出新值。

  5. valueChanges 的任何订阅者都会收到新值。

  6. 控件值访问器 ControlValueAccessory 还会调用 NgModel.viewToModelUpdate() 方法,它会发出一个 ngModelChange 事件。

  7. 由于该组件模板双向数据绑定到了 favoriteColor,组件中的 favoriteColor 属性就会修改为 ngModelChange 事件所发出的值("Blue")。

这个模型到视图的示意图展示了当 favoriteColor 从蓝变到红时,数据是如何经过如下步骤从模型流动到视图的。

  1. 组件中修改了 favoriteColor 的值。

  2. 变更检测开始。

  3. 在变更检测期间,由于这些输入框之一的值发生了变化,Angular 就会调用 NgModel 指令上的 ngOnChanges 生命周期钩子。

  4. ngOnChanges() 方法会把一个异步任务排入队列,以设置内部 FormControl 实例的值。

  5. 变更检测完成。

  6. 在下一个检测周期,用来为 FormControl 实例赋值的任务就会执行。

  7. FormControl 实例通过可观察对象 valueChanges 发出最新值。

  8. valueChanges 的任何订阅者都会收到这个新值。

  9. 控件值访问器 ControlValueAccessor 会使用 favoriteColor 的最新值来修改表单的输入框元素。


数据模型的可变性

变更追踪的方法对应用的效率有着重要影响。

  • 响应式表单通过以不可变的数据结构提供数据模型,来保持数据模型的纯粹性。每当在数据模型上触发更改时,FormControl 实例都会返回一个新的数据模型,而不会更新现有的数据模型。这使你能够通过该控件的可观察对象跟踪对数据模型的唯一更改。这让变更检测更有效率,因为它只需在唯一性更改(译注:也就是对象引用发生变化)时进行更新。由于数据更新遵循响应式模式,因此你可以把它和可观察对象的各种运算符集成起来以转换数据。

  • 模板驱动的表单依赖于可变性和双向数据绑定,可以在模板中做出更改时更新组件中的数据模型。由于使用双向数据绑定时没有用来对数据模型进行跟踪的唯一性更改,因此变更检测在需要确定何时更新时效率较低。

前面那些使用 favorite-color 输入元素的例子就演示了这种差异。

  • 对于响应式表单,当控件值更新时,FormControl 的实例总会返回一个新值。

  • 对于模板驱动的表单,favorite-color 属性总会被修改为新值。

表单验证

验证是管理任何表单时必备的一部分。无论你是要检查必填项,还是查询外部 API 来检查用户名是否已存在,Angular 都会提供一组内置的验证器,以及创建自定义验证器所需的能力。

  • 响应式表单把自定义验证器定义成函数,它以要验证的控件作为参数。

  • 模板驱动表单和模板指令紧密相关,并且必须提供包装了验证函数的自定义验证器指令。

测试

测试在复杂的应用程序中也起着重要的作用。当验证你的表单功能是否正确时,更简单的测试策略往往也更有用。测试响应式表单和模板驱动表单的差别之一在于它们是否需要渲染 UI 才能基于表单控件和表单字段变化来执行断言。下面的例子演示了使用响应式表单和模板驱动表单时表单的测试过程。


测试响应式表单

响应式表单提供了相对简单的测试策略,因为它们能提供对表单和数据模型的同步访问,而且不必渲染 UI 就能测试它们。在这些测试中,控件和数据是通过控件进行查询和操纵的,不需要和变更检测周期打交道。

下面的测试利用前面例子中的 "喜欢的颜色" 组件来验证响应式表单中的 "从视图到模型" 和 "从模型到视图" 数据流。

验证“从视图到模型”的数据流

第一个例子执行了下列步骤来验证“从视图到模型”数据流。

  1. 查询表单输入框元素的视图,并为测试创建自定义的 "input" 事件

  2. 把输入的新值设置为 Red,并在表单输入元素上调度 "input" 事件。

  3. 断言该组件的 favoriteColorControl 的值与来自输入框的值是匹配的。
//Favorite color test - view to model

it('should update the value of the input field', () => {
  const input = fixture.nativeElement.querySelector('input');
  const event = createNewEvent('input');

  input.value = 'Red';
  input.dispatchEvent(event);

  expect(fixture.componentInstance.favoriteColorControl.value).toEqual('Red');
});

验证“从模型到视图”数据流:

  1. 使用 favoriteColorControl 这个 FormControl 实例来设置新值。

  2. 查询表单中输入框的视图。

  3. 断言控件上设置的新值与输入中的值是匹配的。
//Favorite color test - model to view

it('should update the value in the control', () => {
  component.favoriteColorControl.setValue('Blue');

  const input = fixture.nativeElement.querySelector('input');

  expect(input.value).toBe('Blue');
});

测试模板驱动表单

使用模板驱动表单编写测试就需要详细了解变更检测过程,以及指令在每个变更检测周期中如何运行,以确保在正确的时间查询、测试或更改元素。

下面的测试使用了以前的 "喜欢的颜色" 组件,来验证模板驱动表单的 "从视图到模型" 和 "从模型到视图" 数据流。

验证 "从视图到模型" 数据流:

  1. 查询表单输入元素中的视图,并为测试创建自定义 "input" 事件。

  2. 把输入框的新值设置为 Red,并在表单输入框元素上派发 "input" 事件。

  3. 通过测试夹具(Fixture)来运行变更检测。

  4. 断言该组件 favoriteColor 属性的值与来自输入框的值是匹配的。
//Favorite color test - view to model

it('should update the favorite color in the component', fakeAsync(() => {
  const input = fixture.nativeElement.querySelector('input');
  const event = createNewEvent('input');

  input.value = 'Red';
  input.dispatchEvent(event);

  fixture.detectChanges();

  expect(component.favoriteColor).toEqual('Red');
}));

验证“从模型到视图”数据流:

  1. 使用组件实例来设置 favoriteColor 的值。

  2. 通过测试夹具(Fixture)来运行变更检测。

  3. fakeAsync() 任务中使用 tick() 方法来模拟时间的流逝。

  4. 查询表单输入框元素的视图。

  5. 断言输入框的值与该组件实例的 favoriteColor 属性值是匹配的。
//Favorite color test - model to view

it('should update the favorite color on the input field', fakeAsync(() => {
  component.favoriteColor = 'Blue';

  fixture.detectChanges();

  tick();

  const input = fixture.nativeElement.querySelector('input');

  expect(input.value).toBe('Blue');
}));
目录

Anguler9 中文教程总览

Angular9 简介

Angular9 快速上手

Angular9 搭建环境

Angular9 基本概念

Angular9 架构概览
Angular9 模块简介
Angular9 组件简介
Angular9 服务与 DI 简介
Angular9 技能扩展

Angular9 英雄指南

Hero guide 简介
Hero guide 创建项目
Hero guide 编辑器
Hero guide 显示列表
Hero guide 创建特性组件
Hero guide 添加服务
Hero guide 添加应用内导航
Hero guide 从服务器端获取数据
Angular9 词汇表

Angular9 基础知识

Angular9 组件与模板

Angular9 显示数据
Angular9 模板语法
Angular9 用户输入
Angular9 属性型指令
Angular9 结构型指令
Angular9 管道
Angular9 生命周期钩子
Angular9 组件交互
Angular9 组件样式
Angular9动态组件
Angular9 元素

Angular9 表单与用户输入

Angular9 表单简介
Angular9 响应式表单
Angular9 验证表单输入
Angular9 构建动态表单

Angular9 Observable 与 RxJS

Angular9 Observable 概览
Angular9 RxJS库
Angular9 可观察对象
Angular9 可观察对象用法实战
Angular9 与其他技术比较

Angular9 NgModule

Angular9 NgModules 简介
Angular9 JS 模块与 NgMoudule 比较
Angular9 以根模块启动应用
Angular9 常用模块
Angular9 特性模块分类
Angular9 入口组件
Angular9 特性模块
Angular9 提供依赖
Angular9 单例服务
Angular9 惰性加载
Angular9 共享特性模块
Angular9 NgModule API
Angular9 NgModule 常见问题

Angular9 依赖注入

Angular9 依赖注入
Angular9 多级注入器
Angular9 DI 提供者
Angular9 DI 实战
Angular9 浏览组件树

Angular9 通过 HTTP 访问服务器

Angular9 准备工作
Angular9 请求数据
Angular9 处理请求错误
Angular9 向服务器发送数据
Angular9 配置 URL 参数
Angular9 拦截请求和响应
Angular9 跟踪和显示请求进度
Angular9 防抖优化
Angular9 XSRF 防护
Angular9 测试 HTTP 请求

Angular9 路由与导航

Angular9 生成路由应用
Angular9 定义基本路由
Angular9 获取路由信息
Angular9 设置通配符路由
Angular9 嵌套路由
Angular9 相对路径
Angular9 访问查询参数与片段

Angular9 路由器教程

Route 起步
Route 路由模块
Route特性区
Route 子路由
Route 路由守卫
Route 异步路由
Angular9 LocationStrategy 和浏览器网址样式
Angular9 <base href>
Angular9 路由器参考手册

Angular9 安全

Angular9 防范跨站脚本(XSS)攻击
Angular9 信任安全值
Angular9 HTTP级别漏洞

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }