Layui表格reload重载时如何彻底清空之前的搜索参数

陌萱吖_2352

陌萱吖_2352

2026-04-13

585人浏览

原创

reload 时搜索参数未清空,是因为 table.reload() 默认沿用缓存的 where 参数;正确做法是显式传入 where: {} 和 page: { curr: 1 }。

reload 时搜索参数没清空,是因为 where 缓存没重置

layui 的 table.reload() 默认不会覆盖或清空上次请求带的 where 参数,尤其在用 form.on('submit(...)') 提交搜索条件后,这些参数会一直附着在表格实例的配置里。你调 reload(),它只是“再发一次带旧 where 的请求”,不是“重新开始”。

  • 常见错误现象:table.render() 初次加载正常,但点“重置”按钮后调 table.reload(),接口仍收到旧的 keyword、status 等字段
  • 根本原因:layui 表格实例内部维护了一份 config.where,reload() 若不显式传参,就沿用这份缓存
  • 正确做法:每次 reload 都要主动传一个干净的 where: {},而不是只写 {} 或漏掉它

必须显式传空 where: {},不能靠删 DOM 或重置 form 代替

有人以为清空搜索表单(比如 form.val('search', {}))就够了,其实没用——表格请求参数和表单值是两套逻辑。layui 不会自动把 form 值同步进 where,除非你在 submit 回调里手动取值并塞进去。

  • 使用场景:点击“重置”按钮时,既要清表单,也要让表格下次请求不带任何搜索条件
  • 实操建议:在重置逻辑里,同时做两件事:form.val('search', {}) + table.reload('yourTableId', { where: {} })
  • 注意参数差异:where 是对象,不是字符串;写成 where: null 或 where: undefined 依然会继承旧值,只有 where: {} 才真正清空

如果用了 page: { curr: 1 },记得一起重置页码

单纯清 where 不够,用户可能在第 5 页搜了内容,重置后还停在第 5 页,但第 5 页没数据——因为新请求没匹配项,后端只返回了空数组,前端却没跳回首页。

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

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

下载
  • 性能影响:不重置页码会导致无意义的空响应,浪费一次请求
  • 兼容性注意:老版本 layui(2.5.6 之前)对 page.curr 的处理有 bug,建议升级到 2.8+ 或手动加 page: { curr: 1 }
  • 推荐写法:table.reload('yourTableId', { where: {}, page: { curr: 1 } })

封装成函数时,避免闭包里引用旧 where

如果你把 reload 写在事件回调外、用变量存了初始 where,然后反复修改这个对象再传入 reload,那等于一直在改同一个引用——改来改去还是那个对象,清不干净。

  • 容易踩的坑:写成 let searchWhere = {}; ... searchWhere.keyword = val; table.reload({ where: searchWhere }),后续不清空 searchWhere 就永远带着历史值
  • 安全做法:每次 reload 都新建对象,比如 where: { keyword: '', status: '' },或者直接 where: {}
  • 复杂点在于:如果有动态字段(比如时间范围、多选 tag),不能只清空对象,还得确保后端能识别空字符串/空数组为“忽略该条件”,否则可能查出意外数据
事情说清了就结束

相关文章

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

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

下载

相关标签:

layui

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

相关专题

更多
ajax教程
ajax教程

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

2023.06.14

2820

4

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

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

2023.08.31

360

5

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

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

2023.11.15

2653

5

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

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

2024.09.24

1161

6

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

2026.10.16

0

15

Revel框架MVC路由与控制器
Revel框架MVC路由与控制器

本专题聚焦Revel框架MVC核心机制,讲解路由定义、控制器Action、参数绑定、请求响应和反向路由,并结合常见场景梳理接口请求处理流程。

2026.10.16

0

15

Revel框架入门与安装配置
Revel框架入门与安装配置

本专题从Revel框架环境搭建讲起,系统介绍命令行工具安装、项目创建、目录结构、配置文件及热代码重载,帮助开发者快速完成首个Go Web应用。

2026.10.16

0

15

Linux 新手先学哪些命令
Linux 新手先学哪些命令

Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

2026.10.15

0

20

MySQL 忘记密码怎么办
MySQL 忘记密码怎么办

MySQL忘记密码专题汇集不同版本与系统下的root密码重置方法,覆盖MySQL 5.7、8.0、Mac、Linux及本地集成环境,并提示恢复权限与重新登录的检查步骤。

2026.10.15

0

18

热门下载

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

精品课程

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

共87课时 | 12.9万人学习

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

共89课时 | 11.1万人学习

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

共5课时 | 1.6万人学习