Layui数据表格如何实现基于Cookie的分页记录功能

月夜之吻

月夜之吻

2026-08-02

654人浏览

原创

layui表格跨页勾选需手动维护selectedids数组并用cookie持久化,在done回调中通过table.setrowchecked恢复状态;全选仅作用于当前页,且必须确保数据行有唯一id字段。

不能直接靠 layui.table 自身机制实现“基于 cookie 的分页记录”——它不保存、不感知用户在不同分页间的勾选状态。所谓“分页记录”,本质是前端多页选择状态的跨页持久化,必须手动干预。

为什么 table 默认不保留跨页 checkbox 状态

Layui 的 table.render() 每次翻页都会重新请求 URL(带 pagelimit 参数),并完全重绘 tbody。之前页勾选的 input[type=checkbox] 节点被销毁,DOM 状态自然丢失。即使你用 table.checkStatus() 获取当前页选中项,也只返回当前页数据,无法串联多页。

  • 后台分页模式下,服务端只返回当前页数据,前端无全量数据可比对
  • table.setRowChecked() 只对当前渲染行生效,翻页后失效
  • Cookie 不是自动同步机制,必须显式读写

如何用 Cookie 存储并还原多页选中 ID

核心思路:监听 checkbox change 事件,把所有已选中的 ID(如 id 字段值)存入 Cookie;翻页时,从 Cookie 中取出 ID 列表,比对当前页每行的 id 值,调用 table.setRowChecked({index: ..., checked: true}) 还原勾选。

  • 使用 document.cookie 或更稳妥的 js-cookie 库(避免手动解析)
  • ID 列表建议序列化为 JSON 字符串,例如:"[1001,1005,2011]",而非逗号拼接(防 ID 含逗号)
  • 务必在 done 回调里执行还原逻辑——此时表格 DOM 已渲染完成,index 可用
  • 注意:只有开启 id 字段且值唯一,才能准确定位行;若后端未返回 id,需用其他唯一字段替代

示例关键片段:

一个php类用于处理cookie会话
一个php类用于处理cookie会话

一个php类用于处理cookie会话

下载
table.render({
  elem: '#demo',
  url: '/api/list',
  page: true,
  cols: [[
    {type: 'checkbox', field: 'id'},
    {field: 'name', title: '姓名'}
  ]],
  done: function(res, curr, count) {
    // 从 cookie 读取已选 ID 数组
    const selectedIds = JSON.parse(Cookies.get('selectedIds') || '[]');
    // 遍历当前页数据,还原勾选
    res.data.forEach((item, i) => {
      if (selectedIds.includes(item.id)) {
        table.setRowChecked({
          id: 'demo', // 表格实例 ID
          index: i + (curr - 1) * this.limit, // 注意:index 是全局序号,非当前页索引
          checked: true
        });
      }
    });
  }
});

checkbox change 时如何更新 Cookie 并避免重复写入

直接绑定 change 到 checkbox 容易因事件冒泡或多次触发导致 Cookie 频繁写入。更可靠的做法是监听表格工具栏事件(如 lay-event="select")或使用 table.on('checkbox(demo)') 事件,它只在用户主动勾选/取消时触发,且携带完整行数据。

  • table.on('checkbox(demo)', function(obj){...}) 中,obj.checked 表示当前操作是勾选还是取消
  • Set 维护已选 ID 集合,避免数组去重开销
  • 写入 Cookie 前做防抖(如 300ms),尤其在快速连点时
  • 删除某页数据后,记得同步清理 Cookie 中已不存在的 ID(需配合全量 ID 列表或服务端校验)

容易被忽略的兼容性与边界问题

实际部署时,以下三点最容易出错:

  • Cookie 的 pathdomain 必须与表格所在页面一致,否则跨路径访问不到(例如弹出层和父页路径不同)
  • 若用户禁用 Cookie 或浏览器隐私模式,需 fallback 到 sessionStorage,但要注意 sessionStorage 不跨标签页
  • 当某页数据为空(如最后一页不足 limit 条),res.data.length === 0,此时 done 里遍历会跳过,但 Cookie 中残留的 ID 若属于已删数据,将无法还原——需额外设计清理机制

相关文章

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

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

下载

相关标签:

cookie layui layui分页

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

相关专题

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

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

2023.08.11

1111

5

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

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

2023.10.09

2262

6

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

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

2024.03.19

2132

13

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

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

2024.03.22

2322

10

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

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

2024.05.22

336

5

ajax教程
ajax教程

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

2023.06.14

1144

4

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

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

2023.08.31

319

5

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

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

2023.11.15

1019

5

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

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

2024.09.24

918

6

热门下载

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

精品课程

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

共87课时 | 11.4万人学习

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

共89课时 | 9.7万人学习

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

共5课时 | 1.5万人学习