Redux-Form 是针对 React 应用程序中表单管理的强大库,借助 Redux-Form 可以轻松地表单状态,重复表单,异步验证和数据同步。Redux-Form 基础教程及最佳实践旨在帮助前端开发人员更好地了解 Redux-Form 的基本概念,用法和最佳实践。
Redux-Form 基础概念
在深入了解 Redux-Form 之前,我们需要先了解 Redux 的基本概念。Redux 通过将应用程序的状态存储在一个全局对象中来管理应用程序的状态。Redux-Form 建立在 Redux 基础上,通过维护和更新表单数据的方式来确保表单状态的一致性。
表单组件
Redux-Form 开发始于表单组件的创建。表单组件可以是任何 React 表单,例如 form 元素或包含输入字段的自定义组件。表单组件向 Redux-Form 发出以下各种事件:
onSubmit:提交表单。onBlur:在输入字段失去焦点时分派事件。onChange:在输入字段的值发生更改时分派事件。onFocus:在输入字段获取焦点时分派事件。
表单状态
Redux-Form 可能会维护以下两种表单状态:
pristine(未脏):表示表单未被修改,因此即使提交表单将不会调用任何处理程序也不会发出通知。dirty(已脏):表示表单已被修改,因此在提交表单时将调用所有处理程序并发送通知。
表单值
Redux-Form 可能会维护以下类型的表单数据:
initialValues:表单的初始值,通常是从数据库或 API 加载的值。value:当前输入字段的值数组。这是 Redux-Form 中控制的唯一值。syncErrors:同步表单级别验证错误的对象。asyncErrors:异步表单级别验证错误的对象。submitting:如果当前正在提交表单,则为true。submitSucceeded:如果表单已成功提交,则为true。submitFailed:如果表单提交失败,则为true。
表单数据流
Redux-Form 的表单数据流可视为以下三个阶段:
- 提交前:验证表单数据并更新
submitting,submitSucceeded或submitFailed。 - 成功提交:通过更新
submitting和submitSucceeded来表示成功提交表单。此时,可以将请求返回的数据存储在 Redux 应用程序的状态中。 - 失败提交:将
submitting和submitFailed更新为true,并更新错误消息,以便用户了解提交进度。
Redux-Form 最佳实践
在开始使用 Redux-Form 开发复杂表单之前,请确保遵循以下最佳实践:
1. 将相关表单值放在一个单一对象中
Redux-Form 推荐将表单的相关值放在一个单一对象中。因此,如果要存储用户详细信息,可以将其包含在一个对象中,而不是将每个输入字段放在 Redux 应用程序状态树的不同位置。这将使表单输入更易于管理和维护。
2. 使用 Redux-Form 中的验证器
Redux-Form 中具有内置的验证器,可用于验证表单中的输入。这样可以确保表单在提交之前已通过验证,并进行有效性检查以确保表单数据的一致性。
3. 使用 Redux-Form 中的提交处理器
Redux-Form 中内置的提交处理器是一种强大的工具,可用于管理从表单组件中提交的表单数据。Redux-Form 提供了一组默认处理器,可快速创建新的自定义处理器。
4. 避免在 Redux 应用程序状态树中存储过多信息
Redux 应用程序状态树大小的增加可能会使应用程序运行变慢。因此,应避免将太多信息存储在状态树中。将表单数据存储在一个单一对象中,将其与 Redux-FOrm 表单状态剥离,并仅将表单数据存储在应用程序的状态树中,以保持应用程序性能的均衡。
5. 学习如何优化表单输入
使用键盘快捷方式和其他用户定制工具,可以减少在表单输入时发出的 HTTP 请求和几次用户单击。
示例代码
下面是一个非常简单的 Redux-Form 示例:
// www.javascriptcn.com code example
import React from 'react';
import { Field, reduxForm } from 'redux-form';
const FormComponent = props => {
const { handleSubmit } = props;
return (
<form onSubmit={handleSubmit}>
<div>
<label htmlFor="firstName">First Name:</label>
<Field name="firstName" component="input" type="text" />
</div>
<div>
<label htmlFor="lastName">Last Name:</label>
<Field name="lastName" component="input" type="text" />
</div>
<button type="submit">Submit</button>
</form>
);
};
export default reduxForm({
form: 'simpleForm',
})(FormComponent);此表单只是一个用于收集用户的名字的简单表单。该表单组件将呈现两个输入字段,一个提交按钮和一个单一的 <form> 元素,其中所有事件被 reduxForm() HOC 捕获和处理。
在 Redux-Form 中,表单状态和表单值基本上是由 hoc 确定和管理的。reduxForm() 返回处理后的容器组件。该组件接收包括经过验证或转换的提交值在内的将表单状态返回给 Redux 应用程序状态树。这些值可以由组件中的各种函数和 Field 组件访问。这个非常简单的例子只有两个字段,但是,在进行更加复杂的表单操作时,您可以看到通过使用 Redux-Form,控制表单状态和值的灵活性是多么优美和实用。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/67bf9ae00c976d473a44fd53