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 查询异常或命中缓存。

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

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

下载
  • 动态构建 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 页」——这是最常被忽略的视觉错乱点。

  • 只要搜索条件变了,就该回到首页: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

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

相关专题

更多
ajax教程
ajax教程

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

2023.06.14

2560

4

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

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

2023.08.31

340

5

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

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

2023.11.15

2393

5

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

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

2024.09.24

1141

6

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

2026.09.30

80

10

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

2026.09.30

80

14

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

2026.09.30

40

12

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

2026.09.30

40

26

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

2026.09.29

60

15

热门下载

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

精品课程

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

共87课时 | 12.7万人学习

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

共89课时 | 10.9万人学习

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

共5课时 | 1.6万人学习