jQuery DataTables服务端分页异常:多余分页按钮及修正参数后页数不符
DataTables 服务端分页页码不匹配的修复方案
异常本质
你碰到的两个阶段的问题,核心都是服务端模式下的响应字段不符合要求,导致分页计算逻辑出错:
- 初始状态:无论实际返回多少结果,分页栏固定显示1-5个数字页码,点击超出范围的页码会加载空数据
- 补充字段后:分页栏仅显示1个页码,和29条数据、单页20条本该有2个页码的预期不符
根因说明
只要开启serverSide: true配置,DataTables就会完全停用本地数据计数逻辑,所有分页页数的计算不会参考当前拿到的单页数据量,100%依赖接口返回的固定字段。
服务端模式下必须返回的三类核心字段,使用默认字段名时无需额外配置:
draw:对应前端请求携带的请求编号,需原样返回,用于解决异步请求乱序问题recordsTotal:不叠加任何前端搜索、筛选条件时,符合基础查询规则的全量数据总数,数值不会随页码、筛选条件变化recordsFiltered:叠加所有搜索、筛选规则后,最终可展示的有效数据总数,是计算总页数的唯一依据,公式为总页数 = Math.ceil(recordsFiltered / 当前pageLength值)
你之前补充字段时把两个计数参数的取值搞反了。按你描述的“两个参数对应值分别为20和29”的顺序,实际是给recordsFiltered传了20,给recordsTotal传了29。按照这个值算总页数是Math.ceil(20/20) = 1,前端自然只会渲染1个页码按钮。
正确的返回配置
针对29条测试数据、单页长度20的场景,调整后的接口返回结构应该是:
{ "draw": 1, "recordsTotal": 29, "recordsFiltered": 29, "data": [ // 当前页对应的实际行数据,结构和列定义的渲染规则匹配即可 ] }
按照这个值计算,总页数是Math.ceil(29/20) = 2,前端会自动渲染1、2两个数字页码,之前多余的占位页码会自动消失。
容易踩的坑
- 不要把当前页实际返回的行数(比如第一页20条、第二页9条)当成
recordsFiltered的值传入,这个值是固定的全量过滤后总数,不会随页码切换改变 - 如果后端返回的计数字段名和默认值不一致(比如叫
total、count),需要在初始化配置里通过ajax.dataSrc做字段映射,否则前端识别不到正确的计数值,就会触发固定渲染5个页码的兜底逻辑 - 你现有配置里的
pagingType: "numbers"不需要调整,这个分页类型本身就是根据真实总页数渲染对应数量的数字按钮,不存在固定写死5个页码的逻辑
内容的提问来源于stack exchange,提问作者Axel Spiteri
相关产品推荐
相关产品推荐

