必须用templet手动渲染带disabled的checkbox并主动过滤禁用行,因layui对disabled无感;name="laytablecheckbox"不可省;checkstatus结果需手动筛除status为'closed'的行;工具列事件需layui.stope(event)防冒泡;checkbox事件回调首行加if(obj.disabled)return。

不能靠配置项或数据字段直接禁用某行选中,必须用 templet 手动渲染带 disabled 的 checkbox,并在后续逻辑中主动过滤掉这些行——Layui 对 disabled 完全无感,它只认 DOM 元素是否存在。
必须用 templet 替换内置 checkbox 列
内置 {type: 'checkbox'} 不支持按行禁用,写 disabled: true 到数据里完全无效。唯一可靠路径是删掉该列,改用普通列 + 自定义模板:
-
name="layTableCheckbox"必须保留,这是 Layui 识别多选行的硬编码约定,漏掉就进不了table.checkStatus() - 模板里要同时控制
disabled和checked,不能只依赖d.layChecked字段——它不会自动映射到 DOM 状态 - 禁用判断必须基于当前行数据,例如
{{# if(d.status === 'closed'){ }} disabled {{# } }},不能用外部变量或异步结果
示例模板:
<script type="text/html" id="checkboxTpl">
<input type="checkbox" name="layTableCheckbox"
{{# if(d.status === 'closed'){ }} disabled {{# } }}
{{# if(d.LAY_CHECKED){ }} checked {{# } }}
lay-id="{{d.id}}">
</script>
table.checkStatus() 返回结果必须手动过滤
Layui 不会跳过 disabled 的 checkbox,table.checkStatus('demo').data 里照常包含所有行,包括被禁用且视觉上不可点的那些。
- 真实已勾选数据得自己筛:
const cache = table.cache['demo']; const validChecked = cache.filter(d => d.status !== 'closed' && d.LAY_CHECKED); -
res.count不能当“全选”依据,得比对:validChecked.length === cache.filter(d => d.status !== 'closed').length - 如果用了
checkStrictly: true,父子联动不受影响,但结果仍要手动过滤
点击操作按钮时防止行事件冒泡触发选中
操作列按钮(如 lay-event="del")点下去,tr 默认会响应 row 或 checkbox 事件,导致误选中。
- 在
table.on('tool(filter)')回调第一行加layui.stope(event),event必须从obj.event拿,传错参数就失效 - 别写
onclick="return false",Layui 是事件委托绑定,内联写法不生效 - 即使 checkbox 已
disabled,tr 点击仍会触发选中,这个拦截不能省
监听 checkbox 事件时必须判断 obj.disabled
用户点击全选框后,禁用行的 checkbox 状态不会变,但 table.on('checkbox(filter)') 仍可能触发(尤其当模板里真渲染了 input 元素)。
- 回调开头加
if(obj.disabled) return;,否则后续逻辑会把禁用行当成有效选中项参与导出、批量提交等操作 - 不要用
pointer-events: none替代disabled:键盘 Space 键仍可切换、无障碍支持差、checkStatus结果错误
最易被忽略的是:禁用只是 UI 层遮蔽,Layui 内部状态管理完全 unaware——LAY_CHECKED 字段、全选状态、父子联动逻辑,全都对 disabled 视而不见。所有业务逻辑都得自己兜底过滤,一步漏掉,禁用行就真进了提交数据。











