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

layui分页怎么实现树形结构分页

冬明大大_7493

冬明大大_7493

发布时间:2026-09-10 11:05:26

|

460人浏览过

|

来源于php中文网

原创

Layui TreeTable不支持原生分页,所谓“树形分页”实为伪分页:仅对根节点分页,子节点通过懒加载随父节点展开,不参与分页计数;直接套用table的laypage会导致子节点丢失、层级错乱、折叠状态失效。

layui分页怎么实现树形结构分页

Layui 本身不支持 treeTable 的原生分页,所谓“树形结构分页”,本质是伪分页:只对根节点(一级节点)做分页,子节点随父节点懒加载展开,不参与分页计数。

treeTable 分页为什么不能用 table 的 laypage?

因为 treeTable 渲染后所有节点(含子节点)都塞进同一个 <table> DOM 中,而 laypage 是对 table 数据数组做切片渲染——一旦开启树形结构,原始数据就不是扁平数组,而是嵌套对象;直接传给 laypage 会丢子节点、错层级、折叠状态丢失。

  • 你看到的“分页条”如果只是控制根节点数量,那没问题;但若想让第 2 页也显示某父节点的子节点,laypage 无能为力
  • 官方 treeTable 模块(v2.1+)压根没暴露分页参数,limitpage 等字段传了也无效
  • 强行用 table.render() + 手动拼 children 数据 → 子节点无法响应式联动(如复选框父子勾选、展开状态不记忆)

真实可用的分页方案:只分根节点 + 懒加载子节点

这是目前最稳定、Layui 生态内广泛验证过的做法,适用于绝大多数后台管理场景(如权限菜单、商品类目、组织架构)。

  • 后端接口返回两层结构:第一页只返回根节点列表(带 hasChildren: true/false 字段),不含任何子节点数据
  • 前端初始化 treetable.render() 时,设置 tree: truelazy: true,并指定 url 为「按 parent_id 加载子节点」的专用接口
  • 分页组件(laypage)独立挂载在表格上方/下方,监听 jump 事件,每次切换页码时:$.get('/api/nodes?page=2&limit=10', ...) 重新拉取根节点,再调用 treetable.reload() 刷新整表
  • 关键点:reload 时必须传 where: { page: 2, limit: 10 },且不要传 data(否则懒加载失效)

示例 reload 调用:

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

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

下载
laypage.render({
  elem: 'pageDemo',
  count: total, // 总根节点数(后端需额外提供)
  limit: 10,
  curr: 1,
  jump: function(obj, first){
    if(!first){
      treetable.reload('treeTableID', {
        where: { page: obj.curr, limit: obj.limit },
        page: { curr: obj.curr }
      });
    }
  }
});

treeGrid 插件能真分页吗?

第三方插件 treeGrid(如 fly.layui.com/extend/treeGrid)确实封装了分页逻辑,但它仍是“模拟分页”:内部把全部树数据一次性拉下来,前端 JS 做扁平化 + 分页切片,再重新构造成带缩进的 DOM。这带来三个硬伤:

  • 首屏加载慢:1000+ 节点时 JSON 体积大,解析卡顿明显
  • 内存占用高:所有节点保留在 JS 对象里,浏览器容易卡死
  • 无法服务端排序:分页后的数据顺序由前端控制,父子层级可能被切散(比如第 1 页末尾是父节点,第 2 页开头是它的子节点)

所以除非数据量恒定 ≤ 200 条且层级 ≤ 3,否则不建议用 treeGrid 的内置分页。

容易被忽略的关键细节

很多人卡在 reload 后子节点点不开,或者分页跳转后折叠状态全丢了——问题往往出在这几处:

  • treetable.reload() 必须传 id(即初始化时的 id 配置项),不能只靠 elem;漏传会导致新数据渲染但旧实例未更新
  • 后端返回的根节点数据中,每个对象必须含 idparentId(或你配置的 treeId/treeUpId 字段),且值类型要一致(全字符串 or 全数字),混用会导致子节点加载请求发错 parentId
  • 懒加载子节点的接口,返回数据必须是数组,且每个子项仍要带 hasChildren 字段;否则下级箭头不显示,无法继续展开
  • 如果用了 done 回调做自定义操作,注意它在 reload 后也会触发两次(初始化一次、reload 一次),别在里面重复绑定事件

热门AI工具

更多
LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

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

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

DeepSeek

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

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

WorkBuddy

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

豆包大模型

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

相关专题

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

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

2063

2023.08.11

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

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

4383

2023.10.09

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

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

5490

2024.03.19

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

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

4958

2024.03.22

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

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

703

2024.05.22

ajax教程
ajax教程

php中文网为大家带来ajax教程合集,Ajax是一种用于创建快速动态网页的技术。通过在后台与服务器进行少量数据交换,Ajax可以使网页实现异步更新。这意味着可以在不重新加载整个网页的情况下,对网页的某部分进行更新。php中文网还为大家带来ajax的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2280

2023.06.14

ajax中文乱码解决方法
ajax中文乱码解决方法

ajax中文乱码解决方法有设置请求头部的字符编码、在服务器端设置响应头部的字符编码和使用encodeURIComponent对中文进行编码。本专题为大家提供ajax中文乱码相关的文章、下载、课程内容,供大家免费下载体验。

340

2023.08.31

ajax传递中文乱码怎么办
ajax传递中文乱码怎么办

ajax传递中文乱码的解决办法:1、设置统一的编码方式;2、服务器端编码;3、客户端解码;4、设置HTTP响应头;5、使用JSON格式。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2113

2023.11.15

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

0

2026.09.23

热门下载

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

精品课程

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

共98课时 | 17.4万人学习

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

共98课时 | 20.4万人学习

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

共83课时 | 14.7万人学习

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

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