必须通过 layui.use(['form'], function(){ var form = layui.form; form.render(); }) 显式加载并使用 form 模块,且 render 必须在回调内调用,父容器需有 class="layui-form",动态添加后需确保 DOM 已挂载完成再渲染。

form.render() 报错 “form is not defined” 怎么办
这是最常卡住的第一步:你写了 form.render(),但浏览器直接报错,说明 form 对象根本没加载进来。Layui 不是全局自动可用的,必须显式用模块加载机制引入。
确保你在调用前已执行:
layui.use(['form'], function(){
var form = layui.form;
// ✅ 此处 form 才真正可用
$('#container').append(htmlStr);
form.render('select', 'my-filter'); // 注意:render 必须在闭包内调用
});
- 别只靠
<script src="layui.js"></script>就以为万事大吉——layui.use是必须步骤 - 如果在
$.ajax或layer.open的 success 回调里调用,form必须是该作用域内声明的变量(比如var form = layui.form),不能在外部作用域直接写form.render() - 检查控制台是否先报
layui is not defined或Cannot read property 'use' of undefined——那说明连 Layui 本体都没加载成功
动态 append 后 form.render() 无效,但 DOM 确实插入了
元素在页面上能看到,但还是原生样式、没点击响应——大概率是渲染时机早于 DOM 挂载完成,或者容器缺失关键 class。
- 父容器必须有
class="layui-form",哪怕它是个<div>:<code><div class="layui-form"><select lay-filter="xxx"></select></div>;光写<select></select>是没用的 - 别在
.append()后立刻调form.render(),尤其当 HTML 字符串含多个嵌套节点时。推荐加一层保险:$('#container').append(htmlStr).promise().done(() => form.render('select', 'xxx')),或更轻量的setTimeout(() => form.render('select', 'xxx'), 0) - 避免把整段
<form>...</form>插入已有<form></form>内——浏览器会自动截断嵌套form,导致内部元素丢失 - 动态添加了
<input type="checkbox">?得补一句:form.render('checkbox', 'xxx') - 新增了普通文本框或带
lay-verify的输入项?要调form.render('input')或直接form.render()(不带参数)来覆盖全部 - 但注意:
form.render()全量刷新会清掉已选中的值、已触发的验证提示、甚至绑定的事件监听——高频动态增删场景下,优先按需分类型渲染 - 如果用了数组 name(如
name="phone[]"),验证规则注册要用正则匹配item.name,而不是硬写form.verify({ 'phone[]': ... }) - 不要等 Tab 切换完再渲染——而要在每次激活该 Tab 时,手动触发一次
form.render() - 监听 Tab 切换事件:
element.on('tab(filter)', function(){ form.render('select', 'tab-form-filter'); }); - 如果 Tab 内容是异步加载的(比如 AJAX 拉取 HTML),确保在内容插入完成后、且该 Tab 已显示(
layui-show类已加上)再调form.render() - 避免在 Tab 初始化时就对未显示的内容调
form.render(),此时 DOM 虽存在但不可见,渲染无效
为什么只传 'select' 还是刷不出 checkbox 和 input 样式
form.render('select') 只处理下拉框,其他类型得单独指定或兜底刷新。Layui 的 form.render() 不是“智能全量重绘”,而是按类型精确扫描。
标签页(Tab)里动态 append 表单,切换后样式全乱
Tab 切换时内容区域被设为 display: none,Layui 的 form 渲染逻辑无法处理隐藏状态下的 DOM,导致重显后样式错位、组件失活。
最易忽略的一点:动态插入的 <select></select> 如果没有空的 <option value=""></option>,lay-verify="required" 会直接判定为“已选中”,跳过验证;样式可能正常,但逻辑已经失效。


















