必须用 table.on('checkbox(filter)') 监听,且 filter 必须与 table.render() 中的 lay-filter 值完全一致;全选/全不选共用同一回调,需结合 data.type === 'all'(或空字符串)与 data.checked 判断状态,不可仅依赖 data.type 或 data.value。
必须用 table.on('checkbox(filter)') 监听,且 filter 要和 table.render() 中的 lay-filter 值完全一致;全选/全不选都走同一个回调,靠 data.type === 'all' 和 data.checked 判断,但不能只信 data.type。
为什么 table.on('checkbox(filter)') 是唯一入口
layui 表格的复选框是渲染后动态生成的伪元素,真实 <input type="checkbox"> 被隐藏,UI 层由 <div class="layui-form-checkbox"> 模拟。原生 <code>click 或 change 绑定在 DOM 上根本不会触发——你点的是外层 div,事件根本到不了 input。
- 错误写法:
$('thead input[type="checkbox"]').on('click', ...)或document.querySelector(...).addEventListener('change', ...)—— 仅对首次渲染前的 DOM 有效,分页、重载、展开行后全部失效 - 正确路径:只有
table.on('checkbox(userTable)')这个内置事件能穿透 layui 的事件代理层,捕获所有操作(包括表头全选、单行勾选、键盘空格切换) - filter 必须严格匹配:比如
lay-filter="userTable",回调里就得写table.on('checkbox(userTable)'),多一个空格、大小写不一致、或多个表格共用同一 filter 都会导致监听错乱
如何准确区分“全选”和“全不选”
data.type === 'all' 只表示操作对象是表头全选框,data.checked 才是关键布尔值:它为 true 是全选,false 是全不选。但要注意旧版 layui(2.7.x 及更早)中 data.type 可能为空字符串,不能只靠它判断。
- 稳妥做法:先确认
data.type === 'all' || !data.type,再看data.checked - 别依赖
data.value:全选框通常没设value,data.value是undefined,拿它做分支会出错 - 如果表格启用了树形结构或子行展开,
data.type还可能是'child',建议预留分支:if (data.type === 'all' || data.type === 'child')
监听到之后,千万别手动改 DOM
data.checked 是 layui 已经计算好的逻辑状态,不是原生 DOM 属性。你不需要、也不应该用 $(...).prop('checked', true) 去同步子项——这会导致 UI 和内部状态脱节,后续 table.checkStatus() 返回结果错乱。
- 真正要做的只有两件事:
– 实时统计当前页已选数量:调用table.checkStatus('userTable').data.length
– 跨页记住选中项:把data.data.id(单选时)或遍历table.cache['userTable'](全选时)存进全局数组,自己维护selectedIds - 全选框本身的状态(比如是否显示“半选”)需原生设置:
document.querySelector('.layui-table-header input[type="checkbox"]').indeterminate = true,但必须在table.render()的done回调里执行,否则会被 layui 下次渲染覆盖
表头全选框取消操作捕获不到?这是设计如此
table.on('checkbox(filter)') 不会触发表头全选框的点击事件——它只响应行内 checkbox 的勾选变化。表头那个“全选/全不选”动作,layui 内部直接更新了所有行状态,但不抛出独立事件。
- 想捕获“用户点了全选框并取消”,只能监听表格容器的
click事件,委托到表头 checkbox 区域:layui.$('#userTable').on('click', '.layui-table-header input[type="checkbox"]', ...) - 必须加
setTimeout(..., 0):否则读到的checked属性还是旧值,因为 layui 状态更新是异步的 - 判断依据不是 DOM 属性,而是
table.checkStatus('userTable').data.length === 0,这才是真实已选数据量
最易忽略的一点:全选逻辑和表格渲染强耦合。如果你在 table.render() 外提前写了 table.on('checkbox(...)'),或者 layui.use(['table'], callback) 没包住监听代码,事件就永远绑不上——它不是静态注册,而是等表格实例创建完成后才可挂载。











