table.filter()只搜当前页是因为其设计定位为列级轻量筛选，仅对已渲染的当前页DOM数据匹配，不访问table.cache；若需全文搜索，应手动遍历table.cache过滤后调用table.reload()。
table.filter() 为什么只搜当前页，不搜全量数据
因为 table.filter() 是 layui 原生设计的「列级轻量筛选」，它只对已渲染到 dom 的当前页数据做 includes() 匹配，不触碰 table.cache。哪怕你配置了 data 数组初始化，只要开启了分页（page: true），它就默认只筛当前页 —— 这不是 bug，是它的定位：快速响应单页微调，不是全文搜索。
常见错误现象：table.filter('yourTable') 输完关键词表格没变化，或只变了几行；查控制台发现 table.cache['yourTable'] 里明明有 1000 条，但 filter 后还是空。
解决方向只有两个：
- 关掉分页（
page: false），让所有数据进缓存，再用table.filter()—— 仅适合 ≤ 500 条的静态小表 - 放弃
table.filter()，直接操作table.cache['id']手动遍历过滤，再table.reload()—— 这才是多字段全文搜的正路
如何安全遍历 table.cache 实现多字段模糊匹配
核心是别直接读 DOM 或依赖 templet 渲染后的文本，而是从缓存对象取原始字段值，统一转成字符串再判断。否则遇到 null、undefined、数字、日期等类型会报错或漏匹配。
推荐写法（兼容性强）：
立即学习“前端免费学习笔记（深入）”；
const keyword = inputVal.trim();
if (!keyword) return originData; // 空关键词直接返回原数组
return originData.filter(item => {
return Object.values(item).some(val => {
return String(val).toLowerCase().includes(keyword.toLowerCase());
});
});
注意要点：
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
- 用
Object.values(item)覆盖所有字段，避免手动列名拼写遗漏 - 统一
String()转换，防止item.id?.includes()在 id 是数字时失败 - 加
toLowerCase()实现大小写不敏感，比正则更稳、无特殊字符风险 - 别在循环里调
JSON.stringify(item)—— 性能差，且可能把函数、undefined 序列化成奇怪字符串
reload 时必须显式传哪些参数才不丢状态
table.reload() 不是“局部刷新”，它是重建表格实例。漏传关键配置，轻则分页错乱、高度塌陷，重则工具栏消失、列宽归零。
最简安全传参组合（以 ID 为 userTable 为例）：
table.reload('userTable', {
data: filteredData,
page: { curr: 1 },
height: 420,
limit: 10,
cols: originalCols, // 必须和 render 时一致
toolbar: '#toolbarDemo'
});
容易踩的坑：
-
page: { curr: 1 }缺失 → 用户还在第 5 页，reload 后显示空内容 - 没传
height→ 表格自动收缩成一行高，滚动条消失 - 传了
url还同时传data→data被忽略，Layui 仍走 AJAX -
cols引用被修改（比如 push 新列）→ reload 后列顺序/宽度全乱
防抖 + 字段白名单：避免输入卡顿和误匹配
1000 条数据 × 每个对象 10 个字段 × 每敲一个字就遍历一次 = 明显卡顿。真实项目必须加防抖，且建议限定可搜字段。
实操建议：
- 用
setTimeout+clearTimeout控制频率，延迟 300ms 再执行过滤（用户停顿即触发） - 不要全字段搜，定义白名单：
const searchableFields = ['username', 'email', 'city']，然后searchableFields.some(key => String(item[key]).includes(keyword)) - 对 ID 类字段单独处理：用
item.id == keyword（双等号）支持字符串输入匹配数字 ID - 中文输入法下，避免用
indexOf，部分字体渲染会导致偏移，includes()更可靠
最后提醒一句：如果你的表格初始化用了 url，那 table.cache 默认只存当前页数据 —— 此时前端多字段搜根本不可行，得先切到 data 模式，或老老实实走后端 LIKE 查询。
