讲师中心 微信公众号
AI工具推荐 视频效率加速

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

酷静君_4155

酷静君_4155

发布时间:2026-07-08 06:06:27

|

232人浏览过

|

来源于php中文网

原创

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 和实际行为不一致。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

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

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

2283

2023.08.11

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

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

4923

2023.10.09

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

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

6010

2024.03.19

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

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

5518

2024.03.22

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

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

783

2024.05.22

json数据格式
json数据格式

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

2015

2023.08.07

json是什么
json是什么

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

2922

2023.08.23

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

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

996

2023.10.13

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

80

2026.09.30

热门下载

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

精品课程

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

共87课时 | 12.7万人学习

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

共89课时 | 10.9万人学习

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

共5课时 | 1.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn