layui table 的 total 属性只能在 done 回调的第三个参数 count 或 res 对象中获取，需服务端返回 count 字段（或自定义 response.countName），首次加载及 reload 时均须配置 done 才能更新。
layui table 的 total 属性在哪能拿到
layui 的 table 实例本身不直接暴露 total 字段，它只在「数据加载完成后的回调中」才可用。很多人查 table.config 或 table.cache 都找不到，是因为 total 是服务端响应里带回来的字段，且只存在于 done 回调的第三个参数里。
关键点：必须等表格渲染完成、且服务端返回了 count（或你配置的 response.countName）字段后，才能访问到总条数。
-
done回调的第三个参数res是原始响应对象，res.count就是总记录数（默认字段名） - 如果你改过
response.countName: 'total'，那就得用res.total - 别试图在
render()后立刻取 —— 此时异步还没返回，res还不存在
如何在 done 回调里安全读取 total
最稳妥的方式是在初始化表格时显式写好 done 回调，并从参数中解构 res。注意：这个 res 和你传给 data 的原始数据不是一回事，它是整个接口响应体。
table.render({
elem: '#demo',
url: '/api/list',
page: true,
cols: [[{field:'id', title: 'ID'}]],
done: function(res, curr, count) {
// ✅ 正确：count 是 layui 自动提取的总数（基于 res.count）
console.log('总条数：', count);
// ✅ 也可直接从 res 拿（更灵活，尤其你自定义了 countName）
console.log('原始响应里的总数：', res.count);
}
});
-
count参数是 layui 提取后的数值，类型为Number，可直接用于分页计算 - 如果接口返回的是字符串
"123"，layui 会自动转成数字；但如果字段名配错，count会是0，而res.count是undefined - 不要依赖
table.cache['demo'].length—— 那只是当前页的数据量，不是总数
想在外部（比如按钮点击时）获取 total 怎么办
layui 表格实例没有提供类似 getTableTotal() 的方法，所以得自己存。推荐在 done 里把 count 缓存到一个变量或 DOM dataset 上。
let tableTotal = 0;
table.render({
elem: '#demo',
url: '/api/list',
done: function(res, curr, count) {
tableTotal = count;
}
});
// 外部使用
document.getElementById('btn').onclick = function() {
console.log('当前总条数：', tableTotal); // ✅ 可靠
};
- 避免用全局变量？可以挂到
table.config上，但不推荐 —— 它是内部结构，可能被覆盖 - 别监听
table.on('sort(...)')或page(...)事件去重取total，它们不触发done，也不会重新拿到count - 如果表格支持前端分页（
url: null+data: [...]），那total就是data.length，但此时done的count参数仍为0，需特殊处理
为什么有时候 count 总是 0
常见原因就三个：接口没返回 count 字段、字段名不匹配、或者用了前端渲染却误以为有服务端总数。
- 检查接口响应是否包含
{"code":0,"msg":"","count":123,"data":[...]}—— 缺count就必然为 0 - 确认
response.countName和接口字段名完全一致，包括大小写和下划线（如后端返回total_count，就得配response: {countName: 'total_count'}） - 如果用了
data直接传数组（非 url 请求），layui 不会解析count，此时count参数恒为 0，得手动算：data.length
真正容易被忽略的是：layui 的 count 值只在首次加载和重载（table.reload()）时更新，reload 时不传 done，旧的 count 就不会刷新 —— 所以 reload 也得带上 done 才能同步最新总数。
