聊聊使用 Redux Form 解决表单管理的问题

阅读时长 12 分钟读完

在网页应用中,表单管理是一个基本且重要的功能。但是,随着应用复杂度的增加,表单管理会变得越来越棘手。Redux Form 是一个非常优秀的库,用于解决表单管理的问题。

本文将向您介绍 Redux Form 的基本概念、使用方式以及常见问题,帮助您在前端开发中更好地利用 Redux Form。

Redux Form 的基本概念

Redux Form 是一种基于 Redux 的表单管理库,它的基本思路是将表单中的各种状态,比如字段值、对错误的处理、字段可用性等等,都放到 Redux Store 中管理。这样可以有效地解耦表单组件与状态管理器,使得表单使用更加灵活和可维护。

Redux Form 相关术语:

  • Field:字段是表单中最基本的单元,比如输入框、下拉框等等。
  • Form:表单是一组字段的集合,通常表单都有一个名字,用于标识表单。Redux Form 管理多个表单状态,每个表单状态可以通过不同的表单名称进行访问,类似于 Redux 中的“模块化”思路。
  • Form Value:表单值是一组键值对,表示表单中各个字段的值。
  • Form Props:表单属性是通过 reduxForm() API 设置的,用于配置表单的各个属性。

Redux Form 的使用

接下来,我们将通过一个具体的示例来演示 Redux Form 的使用。

安装依赖

在开始之前,请确保您安装了 react-reduxredux-form 两个依赖库。您可以通过下面的命令进行安装:

创建表单组件

我们来创建一个包含输入框和提交按钮的表单组件 ContactForm

-- -------------------- ---- -------
------ ------ - --------- - ---- -------
------ - ------ --------- - ---- ------------

----- ----------- ------- --------- -
  -------- -
    ----- - ------------ - - ----------

    ------ -
      ----- ------------------------
        -----
          ------ ------------------------- ------------
          ------ ---------------- ----------------- ----------- --
        ------
        -----
          ------ ----------------------- ------------
          ------ --------------- ----------------- ----------- --
        ------
        ------- -----------------------------
      -------
    -
  -
-

----------- - -----------
  ----- ----------
---------------

------ ------- -----------

我们在 ContactForm 组件中使用了 Field 组件,该组件表示一个表单字段。通过 namecomponent 就可以定义该字段的名称和类型。在这个例子中,我们在表单中添加了一个输入框,它的名称是 “firstName” 以及一个类型为文本串。

此外,我们还需要将 ContactForm 通过 reduxForm() API 注册,以便在 Redux Store 中管理。

使用表单组件

现在我们已经创建了 ContactForm 表单组件,下一步我们可以在应用中使用它了。我们创建一个父组件 App,用来嵌套 ContactForm

-- -------------------- ---- -------
------ ------ - --------- - ---- -------
------ - -------- - ---- -------------
------ - ----------- - ---- -------
------ ----------- ---- ---------------

----- ----- - -------------- -- ---

----- --- ------- --------- -
  ------ - ------ -- -
    --------------------
  -

  -------- -
    ------ -
      --------- --------------
        ---- ----------------
          ------------ ---------------------- --
        ------
      -----------
    -
  -
-

------ ------- ---

ContactForm 上,我们添加一个 onSubmit 回调函数,当表单提交时,该函数将被调用,打印表单值(即前面提到的 “Form Value”)。

预填表单

有时,我们需要在表单中预填一些值,例如用户信息编辑场景。在 Redux Form 中,我们可以通过 initialValues 属性来实现预填表单。

-- -------------------- ---- -------
------ ------ - --------- - ---- -------
------ - ------ --------- - ---- ------------

----- ----------- ------- --------- -
  -------- -
    ----- - ------------ - - ----------

    ------ -
      ----- ------------------------
        -----
          ------ ------------------------- ------------
          ------ ---------------- ----------------- ----------- --
        ------
        -----
          ------ ----------------------- ------------
          ------ --------------- ----------------- ----------- --
        ------
        ------- -----------------------------
      -------
    -
  -
-

----------- - -----------
  ----- ----------
  -------------- -
    ---------- -------
    --------- ------
  --
---------------

------ ------- -----------

校验表单

在表单应用中,表单校验是一个重要的功能。Redux Form 提供了表单校验的支持。我们可以在 ContactForm 组件中添加一个 validate 函数,用于验证表单字段,在组件中提交表单时将自动被调用。

-- -------------------- ---- -------
------ ------ - --------- - ---- -------
------ - ------ --------- - ---- ------------

----- ----------- ------- --------- -
  ----------- - -- ------ ------ ----- ----- - -------- ----- - -- -- -
    -----
      ----------------------
      -----
        ------ ---------- ------------------- ----------- --
        -------- -- ----- -- ---------------------
      ------
    ------
  -

  -------- - ------ -- -
    --------------------
  -

  -------- -
    ----- - ------------ - - ----------

    ------ -
      ----- ---------------------------------------
        ------
          ----------------
          -----------
          ----------------------------
          ------------ -----
        --
        ------
          ---------------
          -----------
          ----------------------------
          ----------- -----
        --
        ------- -----------------------------
      -------
    -
  -
-

----- -------- - ------ -- -
  ----- ------ - --

  -- ------------------- -
    ---------------- - ----------
  -

  -- ------------------ -
    --------------- - ----------
  -

  ------ ------
-

----------- - -----------
  ----- ----------
  ---------
---------------

------ ------- -----------

我们可以在以下情况下执行字段验证:

  • 表单加载时:validate() 在组件加载时被调用,从而使表单中每个字段都被验证一次。
  • 字段失焦时:当有字段失焦时,validate() 将不再执行,它只会在提交时被调用。如果需要对字段失焦的验证,请使用 onBlur() API。
  • 提交时:validate() 在表单提交时被调用。

发送异步请求

在实际应用中,我们可能需要在表单提交时发送异步请求(比如添加或修改用户数据)。Redux Form 提供了发送异步请求的方法。我们可以通过创建 Promise 对象并在 handleSubmit 函数中调用该 Promise 达到发送请求的目的。

-- -------------------- ---- -------
------ ------ - --------- - ---- -------
------ - ------ --------- - ---- ------------

----- ----------- ------- --------- -
  ----------- - -- ------ ------ ----- ----- - -------- ----- - -- -- -
    -----
      ----------------------
      -----
        ------ ---------- ------------------- ----------- --
        -------- -- ----- -- ---------------------
      ------
    ------
  -

  -------- - ------ -- -
    ------ --- ----------------- ------- -- -
      ------------- -- -
        -------------------
        ---------
      -- -----
    --
  -

  -------- -
    ----- - ------------ - - ----------

    ------ -
      ----- ---------------------------------------
        ------
          ----------------
          -----------
          ----------------------------
          ------------ -----
        --
        ------
          ---------------
          -----------
          ----------------------------
          ----------- -----
        --
        ------- -----------------------------
      -------
    -
  -
-

----- -------- - ------ -- --

----------- - -----------
  ----- ----------
  ---------
---------------

------ ------- -----------

onSubmit 函数中,我们首先创建一个 Promise 对象(这里使用 setTimeout() 模拟异步请求),然后将表单值作为参数进行传递。在组件中,我们通过调用 handleSubmit(props.onSubmit) 函数来异步发送请求,必须要使用 JavaScript 的异步调用方式,handleSubmit() 方法将会返回一个 Promise 对象,我们可以通过该对象来判断请求是否完成。

特别提示

  • Redux Form 的版本正在迭代更新,请保持持续关注。
  • Redux Form 的使用需要了解 Redux 的基本概念。如果您对 Redux 尚不熟悉,请先学习 Redux 的基础知识。
  • 在实际应用中,您需要注意 Redux Form 的性能问题,特别是在组件数量较多的情况下,过度使用 Redux Form 会导致性能问题。可以将 Redux Form 与 React 的 shouldComponentUpdate 生命周期一起使用,以提高组件性能。
  • 文章中的示例代码是针对简单场景构建的,实际应用可能需要更复杂的处理逻辑。大型表单需谨慎使用 Redux Form,确保所有需求都能被满足。

总结

Redux Form 是一个强大的表单管理工具,它可以将表单中各种状态与 Redux Store 中进行解耦,提供了许多有用的方法和 API 来简化表单管理。本文的例子可以帮助您了解 Redux Form 的基本使用,它具有深度和学习价值,希望能为您提供指导意义。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/648c1a0448841e9894a6890e

纠错
反馈