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

冬明大大_7493

冬明大大_7493

2026-09-10

460人浏览

原创

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

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

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

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

因为 treeTable 渲染后所有节点(含子节点)都塞进同一个 <table> DOM 中,而 <code>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 一次),别在里面重复绑定事件

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2023.08.11

2063

5

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

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

2023.10.09

4363

6

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

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

2024.03.19

5490

13

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

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

2024.03.22

4938

10

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

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

2024.05.22

703

5

ajax教程
ajax教程

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

2023.06.14

2260

4

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

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

2023.08.31

340

5

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

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

2023.11.15

2093

5

ajax网站有哪些
ajax网站有哪些

使用ajax的网站有谷歌、维基百科、脸书、纽约时报、亚马逊、stackoverflow、twitter、hacker news、shopify和basecamp等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.09.24

1121

6

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
ThinkPHP配置开发与CMS后台实战
ThinkPHP配置开发与CMS后台实战

共87课时 | 12.4万人学习

第二十三期_综合实战
第二十三期_综合实战

共89课时 | 10.6万人学习

Layui 快速入门精讲
Layui 快速入门精讲

共5课时 | 1.6万人学习