最可靠方式是调用 table.checkStatus('yourTableId') 获取当前页勾选数,其 data.length 即结果;ID 必须与 table.render 中 id 严格一致,否则返回空对象;跨页统计需自行维护 selectedIds 数组。

用 table.checkStatus() 拿当前页勾选数最可靠
别遍历 DOM 或手动维护计数器,Layui 表格的勾选状态是内部管理的,DOM 上的 checked 属性始终为 false,直接查不到真实状态。必须调用 table.checkStatus('yourTableId') 获取快照对象,它的 data.length 就是当前页已勾选项数。
常见错误是传错 ID:这个 'yourTableId' 必须和 table.render({ id: 'yourTableId' }) 里设的 id 完全一致,大小写、空格都不能差。如果没设 id,checkStatus 会返回空对象,.data 是 undefined,取 length 就报错。
- 表格开启分页时,
data.length只统计当前页可见行,不是全部数据 - 如果表格
page: false(无分页),data.length就是全部已勾选项数 - 别在
done回调里直接调checkStatus—— 此时渲染刚完成,用户还没操作,结果恒为 0
form.on('checkbox') 场景下用 $('input[name="xxx"]:checked').length
这是独立表单里(不在表格内)的处理方式。比如筛选条件、配置开关这类普通 ,name 属性一致(如 name="role[]"),就可以用 jQuery 直接统计:
form.on('checkbox(roleFilter)', function(data) {
var count = $('input[name="role[]"]:checked').length;
console.log('已勾选', count, '项');
});
注意点:
- 必须确保所有目标 checkbox 的
name值完全相同,带中括号或不带都行,但要统一 - 不能用
$(data.elem).prop('checked')来累加判断 ——data.elem是当前被点的那个元素,不是全部 - 如果用了自定义 class(如
class="my-check"),建议改用$('.my-check:checked').length,避免 name 冲突
监听事件位置决定统计时机
统计动作必须放在正确的事件回调里,否则拿不到最新值:
- 表格内复选框:必须用
table.on('checkbox(filter)'),form.on('checkbox')完全不触发 - 独立表单复选框:必须用
form.on('checkbox(filter)'),table.on不响应 -
filter值要和渲染时的lay-filter严格一致,重复会导致多个表格互相干扰 - 事件回调里别写
return false—— 它只阻止冒泡,不撤销勾选状态,统计值会滞后一拍
跨页统计要自己存 ID,checkStatus 不管这个
table.checkStatus() 天然只管当前页,如果你需要“总共勾选了多少条(不管在哪页)”,就得自己维护一个全局数组,比如 var selectedIds = [],在 table.on('checkbox') 里根据 obj.checked 和 obj.type 增删 ID:
-
obj.type === 'one':单行操作,增删obj.data.id -
obj.type === 'all':全选/取消全选,需遍历table.cache['yourTableId']当前页所有数据来批量处理 - 每次操作后,
selectedIds.length就是跨页总数 —— 但注意,它不等于 UI 上显示的勾选数,只是你业务逻辑里的“已选 ID 集合”
真正容易被忽略的是:reload 表格后,checkStatus 会清空,但你的 selectedIds 还在;如果要恢复勾选,得在 done 回调里遍历新数据,对 ID 匹配的行调 table.checkRow(),再手动触发一次 checkbox 事件让工具栏同步更新。











