layui的table.reload()默认跳回第一页,因其会丢弃当前分页上下文并从原始配置读取page.curr(通常为1或true);需显式传page: { curr: n }才能保持页码,且应从layui.table.config['id']?.page?.curr实时获取,避免全局变量或dom解析。

table.reload() 为什么 reload 后页码回到第一页
Layui 的 table.reload() 默认会丢弃当前分页上下文,从原始配置中读取 page.curr —— 而你初始化时写的通常是 page: true 或 page: { curr: 1 },所以 reload 后必然跳回第一页。这不是 bug,是设计行为:它把 reload 视为一次“新加载”,而非“刷新当前页”。
后端返回的 curr 字段对前端页码无影响;Layui 只认自己维护的 layui.table.config['yourTableId'].page.curr。
如何安全传入当前页码(不靠全局变量)
最稳的方式是从表格内部状态实时取值,而不是依赖 window.currPage、DOM 解析(比如 $(".layui-laypage-em").next().html())或手动维护变量——这些在快速翻页、异步请求或无数据时极易出错。
-
layui.table.config['yourTableId']?.page?.curr是官方维护的实时页码,每次翻页、搜索后都会自动更新 - 必须传完整对象:
page: { curr: n },只写curr: n无效 - 加空值判断:表格未初始化完成时
table.config['id']可能为undefined,直接取.page.curr会报错
示例:
const currPage = layui.table.config['userTable']?.page?.curr || 1;
table.reload('userTable', {
page: { curr: currPage },
where: { keyword: $('#keyword').val() }
});
reloadData 和 reload 的关键区别
table.reloadData() 是 Layui 2.8+ 新增的轻量方法,它只刷新数据、不重走初始化流程(比如不重建列结构、不重新绑定事件),适合纯数据更新场景。但它和 reload() 一样——也不保留页码,同样需要显式传 page: { curr: n }。
注意点:
- 如果表格列是动态生成的,或已多次绑定 click 事件,用
reloadData()可避免重复绑定 - 若需改列配置、高度、工具栏等,必须用
reload() - 两者都要求手动传
page,否则页码归零
where 参数刷新时最容易漏掉的坑
很多人只改 where 却忘了 page,结果 reload 后回到第一页——因为 where 触发了新请求,但分页没继承,Layui 就当全新加载。
where 是合并进原参数的,不是覆盖。比如之前传过 { id: 123 },这次 reload 传 { status: 'done' },最终请求参数是 { id: 123, status: 'done' }。
想清空旧 where?得显式传完整对象,比如 where: { status: 'done' },必要时配合 method: 'get' 避免缓存。
如果后端返回总条数变少(比如当前是第 5 页,但新数据总共才 20 条,每页 limit=30),Layui 会自动跳转到末页,不会卡住也不会报错。











