Redux-form 使用详解及示例

阅读时长 8 分钟读完

Redux-form 是一个基于 React 和 Redux 的表单管理库。它提供了一种方便的方式来管理表单的状态和验证,并且能够与 Redux store 无缝集成。在本文中,我们将深入探讨 Redux-form 的使用方法,并提供示例代码和指导意义。

安装

首先,我们需要安装 Redux-form。可以使用 npm 或者 yarn 安装:

基本使用

首先,我们需要创建一个 Redux-form 的表单组件。这个组件需要和 Redux store 进行连接。我们可以使用 reduxForm 高阶函数来创建这个组件。

下面是一个简单的例子:

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

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

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

这个组件定义了一个简单的表单,包含了两个输入框和一个提交按钮。Field 组件代表了一个表单输入字段,它需要指定 name 属性作为字段的名称,并且指定 component 属性来指定表单输入组件。在这个例子中,我们使用了 input 组件来渲染输入框。

reduxForm 高阶函数接受一个配置对象作为参数。这个对象中需要包含一个 form 属性,它指定了这个表单的名称。这个名称用于在 Redux store 中存储表单的状态。

现在,我们需要将这个表单组件渲染到页面中。可以使用以下代码来渲染:

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

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

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

这个代码中,我们创建了一个 Redux store,然后将这个 store 传递给 Provider 组件。接着,我们将 SimpleForm 组件渲染到页面中,并且指定了一个 onSubmit 回调函数。这个函数会在表单提交时被调用,并且会传递表单的值作为参数。

表单验证

Redux-form 提供了一种方便的方式来进行表单验证。我们可以使用 redux-form 中的验证器来定义表单验证规则,并且可以在表单提交前进行验证。

下面是一个简单的例子:

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

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

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

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

在这个例子中,我们定义了一个名为 required 的验证器。这个验证器接受一个值作为参数,如果这个值为空,则返回一个错误信息。我们将这个验证器传递给了 Field 组件的 validate 属性中。

现在,我们需要在表单提交前进行验证。可以使用以下代码:

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

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

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

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

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

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

在这个代码中,我们定义了一个名为 validate 的函数。这个函数接受表单的值作为参数,如果表单不合法,则返回一个包含错误信息的对象。我们将这个函数传递给了 reduxForm 高阶函数中,并且指定了一个 onSubmit 回调函数。这个函数会在表单提交时被调用,并且会传递表单的值作为参数。

表单数据初始化

有时候,我们需要在表单中初始化一些数据。可以使用 reduxForm 高阶函数的 initialValues 属性来初始化表单数据。

下面是一个例子:

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

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

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

在这个例子中,我们将 initialValues 属性传递给了 reduxForm 高阶函数。这个属性包含了表单的初始值。

总结

在本文中,我们深入探讨了 Redux-form 的使用方法,并提供了示例代码和指导意义。我们学习了如何创建一个简单的表单,如何进行表单验证,以及如何初始化表单数据。通过学习本文,你可以更好地理解 Redux-form,并且可以在实际项目中使用它来管理表单状态。

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

纠错
反馈