直接设置 elem.readOnly = true/false 即可生效,但必须调用 layui.form.render('input') 同步 UI 和校验;readonly 字段值可提交且受 required 校验,disabled 则不提交且跳过校验;表格中需在 templet 中显式加 readonly 并手动拦截 edit 事件和 focus 行为。
直接用 elem.readonly = true/false 就能生效,layui 不会覆盖它;但只设属性不重绘,视觉和事件可能不同步。
动态设置 readonly 属性后必须调用 form.render()
Layui 的表单样式(比如边框、背景色)和事件绑定(比如校验触发)依赖 form.render()。仅改 DOM 的 readonly 属性,UI 不变、lay-verify 仍会校验该字段——哪怕它已只读。
- 正确写法:
document.getElementById('username').readOnly = true; layui.form.render('input'); - 用 jQuery:
$('input[name="status"]').attr('readonly', 'readonly'); layui.form.render('input'); - 别漏掉参数
'input':只刷新 input 类型控件,避免全表单重绘影响性能
readonly 和 disabled 混用时的提交行为差异
两者都让输入框不可编辑,但语义和行为完全不同:
-
readonly字段的值会随表单提交,form.val()也能取到;disabled字段的值不会提交,form.val()返回undefined -
required校验对readonly字段依然生效,对disabled字段自动跳过 - 用户能聚焦、选中、复制
readonly内容;disabled完全禁用交互,光标都不出现 - 样式上,
disabled默认灰化,readonly保持原样——如需视觉一致,得手动加 CSS,比如background: #f5f5f5; color: #666;
表格中单元格级只读控制容易踩的坑
Layui 表格不支持列级 readonly 配置,得靠 templet 手动拼 input,但有三个关键点常被忽略:
- 在
templet里判断状态后,必须显式加readonly属性,不能只靠 JS 后续设置——因为模板渲染时 DOM 已生成 - 即使加了
readonly,table.on('edit()')仍会触发:Layui 默认监听所有input的 change,得在回调里提前退出table.on('edit(test)', function(obj){ if ($(obj.elem).hasClass('layui-cell-readonly')) return; // 后续逻辑 }); - 要阻止聚焦行为(比如点击后自动失焦),得额外绑定:
$(obj.elem).on('focus', function(){ this.blur(); });
最麻烦的不是设 readonly,而是确保它在各种上下文(表单、表格、弹窗、动态加载)里都保持行为一致——尤其是校验逻辑和提交数据是否包含该字段,这点必须跟后端约定清楚。


















