layui table 的 filter 方法仅在 data 模式下生效，需确保用 data 数组初始化而非 url；触发依赖 lay-filter 与 lay-search 配合；列需显式设 filter: true 或自定义函数才参与筛选；filter 仅筛当前页，reload 才重绘全量数据。
layui table 的 filter 方法不生效？先确认是否启用了 data 模式
layui 表格本地过滤只在 data 模式下有效，也就是用 js 数组直接初始化表格（elem + data），而不是靠 url 异步加载。如果你的表格配置了 url，哪怕数据已经加载完，table.filter() 也不会对已渲染内容做重新筛选——它只作用于原始 data 数组。
实操建议：
- 检查你的
table.render()配置中是否存在url字段；存在就删掉，改用data: [...]初始化 - 确保
data是普通数组，不是 Promise 或异步返回的对象 - 如果必须从接口取数，要在
done回调里拿到响应数据后，再调用table.render({ data: res.data })重绘
怎么用 table.filter() 触发本地搜索？别漏掉 lay-filter
table.filter() 不是自动监听输入框的，它只是个手动触发的筛选函数。真正联动的关键是表格容器的 lay-filter 值和对应表单元素的 lay-search 属性。
常见错误现象：输入后没反应，控制台也没报错，但表格纹丝不动。
实操建议：
- 表格容器（比如
<table id="demo" lay-filter="userTable">）必须有 <code>lay-filter，且值唯一 - 触发搜索的输入框要加
lay-search，并绑定data-filter="userTable"（值需与表格的lay-filter一致） - 不需要手写事件监听，layui 会自动捕获
input事件并调用table.filter("userTable") - 示例片段：
<div class="layui-input-inline"> <input type="text" id="searchName" placeholder="按姓名搜索" class="layui-input" lay-search data-filter="userTable"> </div>
-
filter: true→ 启用默认字符串包含匹配（大小写敏感） -
filter: function(value, item, opts)→ 自定义逻辑，value是搜索关键词，item是当前行数据，返回true表示保留 - 没写
filter的列，无论输什么都不会被匹配到
过滤逻辑跑哪儿去了？自定义匹配得改 cols 里的 filter 字段
默认情况下，table.filter() 只做「全字段模糊匹配」，但你往往只想搜某几列（比如只搜「用户名」或「状态」）。这时候得在列定义里显式声明 filter: true，否则该列不会参与本地筛选。
参数差异：
示例（只让「username」和「status」列可搜）：
cols: [[
{field:'username', title:'用户名', filter: true},
{field:'email', title:'邮箱'}, // 这列不会被搜到
{field:'status', title:'状态', filter: function(val, item){
return item.status === val || item.statusText?.includes(val);
}}
]]
为什么改了数据但过滤结果没更新？table.reload() 不等于 table.filter()
很多人以为调用 table.reload({ data: newData }) 后，之前输入的搜索词会自动应用到新数据上——不会。reload 是彻底重绘，而 filter 是基于当前已渲染数据的二次筛选。两者互不影响。
性能影响：频繁 reload 会触发 DOM 重建，比 filter 开销大得多；但如果你的数据源变了（比如分页切换、条件重选），就必须 reload，不能只靠 filter。
实操建议：
- 纯前端搜索、数据不变 → 用
lay-search+filter，轻量高效 - 数据变了（比如用户点「刷新」或换筛选条件）→ 先
table.reload()，再手动触发一次table.filter("xxx")（如果还想保留上次的搜索词） - 注意：
filter不会清空输入框，也不会重置分页；reload会重置所有状态
容易被忽略的是：filter 只对当前页数据起作用。如果你的表格开启了分页，且没开启 page: false，那它只筛当前页的 10 条，不是全部数据。真要筛全部，得自己维护全量数据数组，再用 reload 推过去。
