讲师中心 微信公众号
AI工具推荐 视频效率加速

layui分页接口返回格式怎么写

雨浩姑娘_3647

雨浩姑娘_3647

发布时间:2026-09-04 15:24:27

|

318人浏览过

|

来源于php中文网

原创

layui laypage分页必须返回含count(数值型)和data字段的JSON,count不可由data.length推算;若后端字段不匹配,需用parse函数映射,且URL参数名须与request配置严格一致。

layui分页接口返回格式怎么写

后端返回的 JSON 结构必须匹配 layui 的 data 字段约定

layui 的 laypage 组件本身不直接请求接口,它依赖你用 laypage.render() 配合 request 和 parse 选项来对接后端。关键不是“layui 要什么格式”,而是你告诉它“总条数在哪”“当前页数据在哪”——它靠 parse 函数从响应里抠出来。

最常见错误是后端返回了 { "code": 0, "msg": "", "data": [...] },但没提供 count(总记录数),导致分页器无法计算页码数,只显示“第 1 页 / 共 0 页”。

  • 必须返回一个包含 count 字段的 JSON 对象(数值类型,不能是字符串)
  • data 字段可以是数组(当前页数据列表),也可以是对象(需在 parse 中提取)
  • 推荐结构:{"code":0,"msg":"","count":123,"data":[{"id":1,"name":"a"}]}
  • 如果后端习惯把列表放在 list 或 items 下,必须用 parse 映射过去

laypage.render() 中的 parse 怎么写才能对上后端字段

当后端响应结构不标准时,parse 是唯一可靠解法。它接收原始响应对象,返回一个固定结构的对象给 laypage 内部使用。

例如后端返回:{"status":true,"total":200,"rows":[{"uid":1},{"uid":2}]},你需要这样写:

深蓝色网站后台管理系统layui框架模板-AdminPro
深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统layui框架模板

下载
laypage.render({
  elem: 'demo',
  count: 1000,
  curr: 1,
  limits: [10,20,50],
  request: { page: 'currentPage', limit: 'pageSize' },
  parse: function(res) {
    return {
      count: res.total,     // 总数,必填
      data: res.rows        // 当前页数据数组,必填
    };
  }
});
  • parse 函数必须返回含 count 和 data 两个 key 的对象
  • 返回的 count 值会被 laypage 用于计算总页数,务必确保是准确整数
  • 如果后端没传总数(比如只给了当前页数据长度),你不能在这里硬写 res.data.length * res.currentPage——这会出错,应让后端补全 count

为什么 count 不能从 data.length 推算

因为分页器需要知道“总共多少页”,而 data.length 只反映当前页条数(比如每页 10 条,最后一页可能只有 3 条)。如果后端不返回真实总数,laypage 会误判页码范围,翻页时可能空白或重复。

  • 前端永远无法仅凭单页数据反推总数,这是分页逻辑的基本前提
  • 某些开发会尝试在 parse 里发二次请求取总数——不可行,laypage 渲染和跳页都依赖同步返回的 count
  • 如果后端确实无法提供总数(如 ES 深度分页场景),需改用“下一页游标”模式,此时 laypage 不适用,应换 loadmore 或自定义加载

接口 URL 参数名要和 request 配置严格一致

layui 默认用 page 和 limit 传参,但很多后端用 pageNum/pageSize 或 offset/limit。必须显式声明,否则参数根本不会发过去。

  • 写成 request: { page: 'pageNum', limit: 'pageSize' } 后,请求 URL 就会是 ?pageNum=2&pageSize=10
  • 若后端要求 offset=10&limit=10,得手动算:request: { page: 'offset', limit: 'limit' },再在 jump 回调里转换(offset = (curr - 1) * limit)
  • 参数名大小写敏感,PageNum ≠ pageNum

后端字段命名自由,但 count 和 data 的语义责任必须由前端通过 parse 显式承接——这里最容易漏掉 count 或类型写错(比如传了字符串 "123")。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2523

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

5443

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

6470

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

6098

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

863

2024.05.22

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2115

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3222

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1096

2023.10.13

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

20

2026.10.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
第十三期_前端开发
第十三期_前端开发

共98课时 | 17.8万人学习

第十二期_前端开发
第十二期_前端开发

共98课时 | 20.8万人学习

周末班(第一期)_前端开发
周末班(第一期)_前端开发

共83课时 | 15万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn