Layui数据表格Reload重载时如何携带搜索参数

千晨同学_8103

千晨同学_8103

2026-06-05

1049人浏览

原创

table.reload() 仅 where 参数生效,需将搜索条件置于 where 对象内,且须显式重置 page.curr=1、手动保存还原 initSort 和勾选项,否则导致页码错乱、状态丢失等问题。

table.reload() 的 where 是唯一生效的参数入口

调用 table.reload() 时,只有配置对象里的 where 字段会被合并进请求参数;其他字段(如直接写 keyword: 'abc')全被忽略。这不是 bug,是 layui 的设计约定。

常见错误现象:table.reload('userTable', { keyword: 'test' }) 发出去后接口收不到 keyword —— 因为没包在 where 里。

  • where 必须是对象,不能是 null、undefined 或字符串
  • 想保留初始化时的 where: { token: 'xxx' },就得手动合并:where: $.extend({}, initWhere, { keyword: val })
  • ES6 可用展开运算符:where: { ...initWhere, keyword: val }
  • POST 模式下,where 会作为 JSON body 发送,后端需支持解析原始 JSON(如 Express 要配 bodyParser.json())

搜索参数为空时怎么避免传给后端?

用户没填关键词、状态选了“全部”,但你仍把 { keyword: '', status: '' } 塞进 where,后端可能误判为“查空字符串”,导致 SQL 查询异常或命中缓存。

  • 动态构建 where 对象,只添加非空值:if (val) params.keyword = val
  • 日期控件注意格式:laydate 返回 "2024-01-01",后端若要 "2024/01/01" 就得先转换
  • 下拉框选“全部”时,建议设其 value 为 '' 或 null,再统一过滤掉 falsy 值
  • 用 new FormData(formEl) 收集表单值时,记得 Object.fromEntries() 后再删空字段

重载后页码还停在第 5 页?必须显式重置 page.curr

用户在第 5 页搜了个词,reload 后不带 page: { curr: 1 },请求仍发 page=5,结果返回空数组,UI 显示「第 5 页 / 共 0 页」——这是最常被忽略的视觉错乱点。

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

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

下载
  • 只要搜索条件变了,就该回到首页:page: { curr: 1 }
  • 如果想保留当前页码(极少见),得先读 table.config['yourTableId']?.page?.curr,但要注意该值可能滞后于 UI,稳妥做法是监听 table.on('page()') 存变量
  • 老版本 Layui(2.5.6 之前)对 page.curr 重置有 bug,建议升到 2.8+ 或强制加 page: { curr: 1 }
  • limit 不用每次传,Layui 会自动继承,除非你要临时改每页条数

reload 后排序和勾选项全丢了,怎么保持?

Layui reload 是销毁重建 DOM,所以排序状态、已勾选行 ID 都不会保留。这不是参数没传对,是机制如此。

  • 排序状态要自己存:let sortState = { field: 'id', type: 'asc' },在 table.on('sort(yourTable)', ...) 里更新,reload 时传 initSort: sortState
  • 勾选项无法自动恢复,得 reload 前用 table.checkStatus('yourTable') 取出 data 或 ids,reload 完再遍历 table.checkRow()(前提是表格启用了 id 字段且唯一)
  • 频繁筛选+排序的场景,建议切到前端 data 模式,避免反复请求后端
  • 并发 reload(比如连点两次搜索)会导致状态竞争,需加 loading 锁或用 abort() 取消前序请求

重载逻辑里最容易漏的是三件事:显式清空 where: {}、强制重置 page: { curr: 1 }、手动保存并还原 initSort 和勾选 ID —— 这些都不在参数自动继承范围内,得每一处 reload 都亲手写进去。

相关文章

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

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

下载

相关标签:

layui layui数据表格

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

相关专题

更多
ajax教程
ajax教程

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

2023.06.14

3220

4

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

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

2023.08.31

360

5

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

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

2023.11.15

3053

5

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

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

2024.09.24

1161

6

Tailwind CSS 如何制作导航栏和卡片
Tailwind CSS 如何制作导航栏和卡片

用 Tailwind CSS 制作导航栏和卡片,可先搭建语义化结构,再组合 Flex、Grid、间距、圆角与阴影类。这里整理横向导航、移动端菜单、卡片网格及悬停效果的相关文章,帮助你把常见页面组件做得清晰且适配不同屏幕。

2026.11.03

0

17

Tailwind CSS 响应式布局怎么写
Tailwind CSS 响应式布局怎么写

Tailwind CSS 响应式布局通常从移动端样式写起,再用 sm、md、lg 等前缀调整不同屏幕宽度下的网格、间距和导航。本专题整理断点配置、Grid 与 Flex 自适应布局及常见溢出问题,帮助你逐步完成多设备适配。

2026.11.03

0

19

Tailwind CSS 常用类名怎么记
Tailwind CSS 常用类名怎么记

Tailwind CSS 类名很多,先按布局、间距、文字、颜色和状态分组记忆,再通过官方文档检索具体写法。本专题结合类名排序、动态拼接失效、自定义实用类等问题,帮助你建立常用类名的速查方法。

2026.11.03

0

12

码上飞入口地址合集
码上飞入口地址合集

本专题汇总了码上飞(CodeFlying)的官方入口地址合集,涵盖官网主站及网页版在线使用入口,支持注册登录后直接在线体验零代码AI应用生成。同时整理了APP端下载渠道与小程序入口,助你快速访问平台,通过自然语言描述需求即可生成应用、小程序或网站。

2026.11.03

0

10

Uvicorn 报错与问题解决教程
Uvicorn 报错与问题解决教程

本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集,涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案,助你快速定位并解决Uvicorn运行中的各类问题。

2026.11.02

20

14

热门下载

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

精品课程

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

共87课时 | 13.1万人学习

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

共89课时 | 11.4万人学习

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

共5课时 | 1.6万人学习