npm 包 eea-react-form 使用教程

阅读时长 4 分钟读完

简介

eea-react-form 是一个基于 React 的表单组件库,封装了一些常见的表单组件和验证规则,使表单的开发变得更加简单、快速和可靠。

安装

在使用 eea-react-form 之前,需要先安装相关依赖:

使用

与其他 React 组件一样,eea-react-form 可以被导入并且在 JSX 中使用。以下是一个简单的示例:

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

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

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

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

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

在这个示例中,我们定义了两个字段(username 和 password),并且将它们传递给了相应的输入框,通过 useForm hook 定义了一个表单提交函数。

验证规则

eea-react-form 内置了许多常见的验证规则,例如 requiredminLengthmaxLengthpattern 等等。你可以在 useField hook 中传递一个对象,来定义这些规则。

以下是一些常见的示例:

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

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

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

自定义验证规则

如果内置的验证规则不满足你的要求,你也可以自定义验证规则。以下是一个自定义验证规则示例:

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

在这个示例中,我们定义了一个密码字段,并且自定义了一个 validate 函数,用于判断密码是否包含了“password”字符串。如果包含,就返回一个错误信息。

提交表单

在表单提交函数中,我们可以调用 useForm hook 返回的 submit 函数来提交表单。当表单验证通过后,submit 函数会自动调用回调函数,并且将表单数据传递给它。

以下是一个 onSubmit 回调函数的示例:

结语

eea-react-form 是一个非常优秀的 React 表单组件库,它简化了表单的开发过程,使得表单的开发变得更加容易、快速和可靠。如果你正在开发 React 应用,建议尝试使用一下它。

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