npm 包 @noticeable/fulect 使用教程

阅读时长 6 分钟读完

什么是 @noticeable/fulect?

@noticeable/fulect 是一个快速生成表单的工具库,提供了多种组件和表单验证方法,能够快速构建一个符合设计要求的表单页面。

安装

安装最新版的 @noticeable/fulect:

使用示例

下面以一个简单的表单为例,展示如何使用 @noticeable/fulect。

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

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

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

首先引入 @noticeable/fulect

然后在 JavaScript 文件中使用 createForm 来创建表单:

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

createForm 的参数中,我们使用了 inputsonSubmit 这两个字段来描述表单的验证规则和提交后的回调函数。

其中,inputs 表示每个表单元素的验证规则。上面的代码中,我们要求 nameemail 字段为必填字段。

onSubmit 表示提交表单后的回调函数,其中 formData 参数表示用户提交的表单数据。

最后,我们调用 form.mount() 方法来将表单挂载在对应的 HTML 元素上:

完成后,即可在页面中看到对应的验证提示信息,如下图所示:

表单验证

使用 inputs 字段可以为表单元素添加各种验证规则,以满足不同的设计要求。

必填字段

required 属性设置为 true 来让某个表单元素为必填字段。

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

数据类型

可以通过 type 属性来指定表单元素的数据类型,目前支持 text, email, number, date, time, datetime 等常见数据类型。

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

正则表达式验证

可以使用 match 属性来指定一个正则表达式,用于对表单元素的值进行验证。

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

数值范围验证

可以使用 minmax 属性来限制数值型表单元素的范围。

字符串长度验证

可以使用 minLengthmaxLength 属性来限制字符串型表单元素的长度范围。

自定义错误提示消息

可以使用 error 属性来设置表单元素的错误提示消息。

表单提交

使用 onSubmit 字段可以指定表单提交时的回调函数,我们可以在这个函数中获取到用户提交的表单数据。

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

总结

本文介绍了 @noticeable/fulect 这个 npm 包的基本使用方法,包括表单的验证和提交。通过这个工具库,我们能够快速、方便地生成符合设计要求的表单页面,提升了前端开发的效率。

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

纠错
反馈