必须手动监听搜索框的keydown事件并调用table.reload()，因Layui表格不自动处理表头搜索框回车；table.on('tool')仅响应点击操作，不捕获键盘事件；表头搜索框为自定义DOM，需在done回调中用layui.$精准绑定，或用事件委托避免重复绑定，且reload时须设page.curr:1并确保where字段名与后端一致。
必须手动监听搜索框的 keydown 事件，判断 enter 键并调用 table.reload()，layui 表格本身不自动处理表头搜索框的回车行为。
为什么 table.on('tool') 捕获不到回车？
Layui 的 table.on('tool(filter)') 只响应点击类操作（如工具栏按钮），对键盘事件完全无感知。表头搜索框是你自己插入的 DOM（比如在 cols 中用 toolbar 模板或直接操作 thead），Layui 不会为它自动绑定任何键盘事件逻辑。
常见错误现象包括：
- 绑了
keydown却没调table.reload()，看起来“按了没反应” - 没加
e.preventDefault()，导致整个页面刷新或表单提交 - 从
data.field读搜索值——那是行数据对象，不是输入框的value
如何在 done 回调里安全绑定回车事件？
done 是表格 DOM 渲染完成后的唯一可靠时机，避免因 DOM 尚未生成导致选择器失效或重复绑定。
- 用
layui.$('input[name="username"]')精准定位目标输入框，别用模糊的.layui-input - 只响应
e.key === 'Enter'（比keyCode更现代、兼容性更好） - 必须加
e.preventDefault()，否则浏览器可能触发表单 submit 或页面跳转 - 读取值用
this.value.trim()，确保空格不影响查询 - 调用
table.reload('yourTableId', { where: { username: this.value.trim() }, page: { curr: 1 } })，强制回到第一页
示例片段：
table.render({
elem: '#demo',
id: 'userTable',
url: '/api/user',
cols: [[
{ field: 'username', title: '用户名', toolbar: '#usernameTpl' }
]],
done: function(res, curr, count){
layui.$('input[name="username"]').on('keydown', function(e){
if(e.key === 'Enter'){
e.preventDefault();
table.reload('userTable', {
where: { username: this.value.trim() },
page: { curr: 1 }
});
}
});
}
});
用事件委托替代重复绑定更稳妥
如果表格会频繁 reload 或切换列配置，每次重绘都会重建表头 DOM，done 里直接绑定会导致事件监听器堆积。推荐把监听器挂到稳定父容器上：
- 给表格容器加个 ID，比如
id="userTableContainer" - 用
layui.$('#userTableContainer').on('keydown', 'input[name="username"]', ...) - 这样即使输入框被销毁重建，事件仍能捕获，且不会重复绑定
- 注意：委托监听时，
this指向的是input元素，可直接读this.value
table.reload() 容易忽略的两个细节
看似只传 where 就够了，但实际出问题最多的是这两点：
-
page.curr: 1必须显式设置——用户若在第 5 页搜，不重置会导致请求第 5 页匹配数据，而结果可能不足一页甚至为空 -
where对象里的字段名要和服务端接口严格一致，比如后端接收q_username，你就不能传username，否则白搜
复杂点在于：多列独立搜索时，每列输入框要各自拼 where，且需同步清空其他列的值（或允许组合条件），这些逻辑得你自己控制，Layui 不介入。
