Layui如何实现基于JSON配置的动态表单生成器

酷静君_4155

酷静君_4155

2026-07-08

232人浏览

原创

layui表单动态生成必须严格遵循其字段映射规则:type值须为内置类型(如text、select等),select/radio/checkbox需options含value和title,date需lay-key,name须唯一非空且扁平化;生成后必须调用form.render(),嵌套json需展平,verify规则须手动注册,disabled/readonly需手动设置。

能直接用,但必须严格匹配 layui.form 的字段映射规则,否则表单控件不渲染、验证失效或值无法回填。

JSON 字段名和 type 值必须与 Layui 内置组件对齐

Layui 不识别任意字段名,它只认预设的 type 类型(如 text、select、checkbox、radio、date 等),且每个类型依赖特定字段参与渲染:

  • type: "select" 时,必须提供 options 数组,每个项含 value 和 title(不是 label 或 name)
  • type: "checkbox" 或 type: "radio" 时,options 必须是数组,且每项需有 value 和 title;若缺 title,选项文字为空
  • type: "date" 需要显式声明 lay-key(用于绑定 laydate 实例),否则日期控件不激活
  • name 字段必须唯一且非空,它是表单序列化和验证的依据;重复或为空会导致 form.val() 读不到值

动态生成前必须调用 form.render(),且时机不能错

仅靠拼 DOM 不会触发 Layui 表单样式和事件绑定。常见错误是:生成完 <input> 就结束,没通知框架重绘。

  • 所有字段 DOM 插入完成后,必须执行 layui.form.render('all') 或指定类型如 layui.form.render('select')
  • 如果表单嵌在弹层(layer.open)里,要在 success 回调中调用 render,不能放在 content 字符串里就完事
  • 若 JSON 配置含 verify 规则(如 "required|email"),还需同步调用 form.verify() 注册自定义校验,否则验证不生效

form.val() 读写依赖 name 属性,JSON 中 name 不能含点号或方括号

Layui 的 form.val('filterName', data) 和 form.val('filterName') 仅支持扁平 name,例如 username、user_email 可用,但 user.info.name 或 items[0].price 会被忽略。

Feishu calendar sync, local ics to json data for AI agent
Feishu calendar sync, local ics to json data for AI agent

将ICS日历文件转为JSON格式,用于飞书日历导入导出及数据集成。

下载
  • 后端返回的嵌套结构 JSON,必须在前端展平后再喂给表单生成逻辑
  • 回填时若字段不存在于当前 DOM,form.val() 静默失败,无报错 —— 建议生成后用 $('[name="xxx"]').length 校验字段是否真实存在
  • checkbox/radio 的初始选中状态靠 value 匹配,不是靠 checked: true 字段;多选 checkbox 要传数组,单选 radio 传字符串

验证规则字符串需提前注册,不能仅靠 JSON 里的 verify

verify 字段只是声明规则名(如 "required|mobile"),但 Layui 不内置 mobile,必须手动用 form.verify({ mobile: [...] }) 定义。

  • 常见漏注册:自定义手机号、身份证、密码强度等规则,JSON 里写了却没在 JS 中 form.verify()
  • 规则函数返回 false 或字符串才会触发提示;返回 undefined 或 true 视为通过
  • 若 JSON 中 verify 是空字符串或 null,Layui 会跳过该字段验证,但不会报错 —— 容易误以为“没生效”其实是配置被忽略了

最易被忽略的是:Layui 表单动态生成不自动处理 disabled、readonly 状态,也不响应 JSON 中的 disabled: true 这类字段 —— 这些得靠生成后手动加 attr('disabled', 'disabled'),否则 UI 和实际行为不一致。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

layui js json

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2283

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

4923

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6010

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

5518

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

783

5

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2015

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

2922

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

996

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

3299

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
ThinkPHP配置开发与CMS后台实战
ThinkPHP配置开发与CMS后台实战

共87课时 | 12.7万人学习

第二十三期_综合实战
第二十三期_综合实战

共89课时 | 10.9万人学习

Layui 快速入门精讲
Layui 快速入门精讲

共5课时 | 1.6万人学习