layui分页需后端返回total（或count）字段，前端配置elem、count、limit缺一不可；点击无反应或总数为0多因后端未返回总数或前端未传入；table模块已集成分页时勿重复调用laypage.render()。
layui 分页需要后端配合返回 total 字段
layui 的 laypage 本身不自动请求数据，只负责渲染页码和绑定点击事件。如果你发现页码显示了但点击没反应、或者总数一直为 0，大概率是后端没返回 count（或 total）字段，而前端又没手动传进去。
常见错误现象：laypage.render() 执行后只显示“第 1 页”，页码栏空白，控制台无报错；或者翻页时 curr 参数正确，但接口没被触发。
- 后端响应必须包含总条数字段，推荐用
count（layui 默认识别），也可用total配合countName: 'total' - 前端发起的分页请求，URL 中应带
page和limit参数（如?page=2&limit=10），后端据此做 offset/limit 或 page/size 处理 - 不要在
jump回调里重复调用laypage.render()，否则会无限递归渲染
laypage.render() 的必要参数不能少
漏掉 elem、count、limit 中任意一个，分页就无法正常工作。尤其是 elem 必须是容器的 DOM ID（不带 #），且该元素初始内容应为空。
典型配置示例：
laypage.render({
elem: 'demo', // 注意：这里是字符串 'demo'，不是 '#demo'
count: 123, // 总数，必须是数字，不能是字符串 "123"
limit: 10, // 每页条数
curr: 1, // 当前页，可从 URL 或本地缓存读取
theme: '#3980ff',
jump: function(obj, first) {
if (!first) {
// 非首次渲染时才发请求
$.get('/api/list?page=' + obj.curr + '&limit=' + obj.limit, function(res) {
// 渲染列表内容，注意：这里不调用 laypage.render()
$('#list').html(template(res.data));
});
}
}
});
如何让当前页高亮并同步 URL 参数
layui 默认不会修改地址栏，也不感知浏览器前进/后退。如果用户手动改 URL 中的 page，分页组件不会自动响应——这需要你主动解析。
- 用
location.search提取page值，转成数字后传给curr选项 - 在
jump回调中用history.replaceState()更新 URL，避免新增历史记录 - 监听
popstate事件，在用户点浏览器后退时重新执行分页逻辑（需配合全局变量缓存参数） -
layout数组控制按钮顺序，比如['count', 'prev', 'page', 'next', 'skip', 'limit']，其中skip是跳页输入框，limit是每页数量下拉
与 table 模块混用时别直接套用 autoResizing
如果你用的是 layui.table，它内置了分页（page: true），此时不需要再手动调用 laypage.render()。强行叠加会导致两个分页控件并存、事件冲突、总数计算错乱。
判断依据：table.render() 中已设置 page: true，且服务端返回结构含 data 和 count 字段，layui 就会自动处理所有分页交互。
- 想自定义页码样式？改
table的page.bar或用 CSS 覆盖.layui-table-page - 想禁用 table 自带分页改用手动 laypage？设
page: false，然后自己管理数据加载和页码渲染 - table 的
limits和limit参数会影响 laypage 的limits显示，两者值要对齐，否则选每页 20 条时接口却传 10
最常被忽略的一点：后端返回的 count 必须是「满足查询条件的总条数」，而不是全表 COUNT(*)。过滤条件变了，这个数就得跟着变，否则页码逻辑全错。
