必须加原生disabled属性并立即调用form.render('input'),仅设class或JS属性不生效;动态禁用需确保DOM插入、Layui加载完成后再操作;disabled字段值无法读取和提交,需用readonly模拟。

直接加 disabled 属性,但必须调 form.render('input')
加 disabled 是唯一可靠方式,Layui 不会自动同步原生属性和 UI 状态。只写 <input disabled> 或只用 JS 设置 elem.disabled = true,UI 仍可点击、样式也不变灰——这是最常踩的坑。必须紧接着调 form.render('input'),否则禁用就是“假的”。如果页面有多个表单,建议传第二个参数指定 filter,比如 form.render('input', 'my-form'),避免误刷其他区域。
layui-disabled 类只是视觉补充,不能替代 disabled 属性
单独加 class="layui-disabled" 不起作用:它只改背景色和字体颜色,不阻止聚焦、不拦截输入、提交时字段值依然会被带上。真实禁用必须依赖原生 disabled 属性。但可以配合使用——加 disabled + layui-disabled,让灰度更明显,尤其在自定义主题下更稳妥。注意不要只靠 class 做逻辑控制,后端校验和提交前 DOM 状态检查(elem.disabled === true)才是关键。
动态禁用时,渲染时机比写法更重要
常见失败场景是 AJAX 加载完表单再禁用,但 form.render('input') 调早了(DOM 还没插入)或调晚了(用户已点过)。正确顺序是:
• 插入 HTML 后
• 确保 layui.use(['form'], function(){...}) 已执行
• 再设 disabled 属性
• 立即调 form.render('input')
漏掉任一环,禁用就不可见或不可靠。如果用了 jQuery,别用 .attr('disabled', 'disabled'),改用 .prop('disabled', true),避免布尔值解析错误。
禁用后值读不到、提交不带出,是浏览器行为,不是 Layui Bug
form.val() 拿不到 disabled 字段的值,哪怕你 JS 手动改过 value,这是浏览器规范限制。同样,表单 submit 时该字段也不会出现在序列化结果里。如果你需要“禁用但保留值”,得换思路:用 readonly + 样式模拟禁用(比如加 layui-disabled 类),再手动在 form.on('submit') 回调里校验 elem.readOnly 并跳过验证规则。真正卡住人的,从来不是怎么写,而是 DOM 状态、Layui 渲染状态、浏览器原生行为三者没对齐。


















