直接在toolbar里写HTML字符串最简单，但必须外层加layui-form类、input带name属性、整个字符串用双引号包裹；name值须与form.on('submit(filter)')中filter一致，且table.reload()需传正确表ID、where参数及page.curr=1。
直接在 toolbar 里写 HTML 字符串最简单，但必须满足三个硬性条件：外层包 layui-form、input 带 name 属性、整个字符串用双引号包裹。漏掉任一条件，搜索框就收不到值或样式错乱。
toolbar 配置里怎么写搜索框 HTML
不能写成单引号字符串，也不能省略 name；Layui 只原样插入，不解析变量或模板语法。
- 正确写法：
"<div class='layui-form'><input type='text' name='keyword' placeholder='关键词' class='layui-input'></div>" -
name值必须和后续form.on('submit(filter)')中的filter一致（比如这里就是keyword） - 外层
layui-form不可少——否则form.on事件委托失效，且输入框左右 padding/圆角会异常 - 别加
lay-search或lay-type="search"，那是给独立表单用的，嵌在 toolbar 里反而冲突
怎么让点击搜索真正触发表格重载
toolbar 区域本身没逻辑，所有行为都得手动绑定。常见错误是点了没反应，本质是 table.reload() 没调对或参数缺失。
- 监听方式推荐两种之一：
— 用form.on('submit(keyword)')（前提是input的name="keyword"且外层有lay-submit）
— 或直接给按钮绑click，例如：$('.layui-table-tool .layui-btn').on('click', function(){...}) -
table.reload()第一个参数必须是渲染时指定的id，如table.render({ id: 'userTable', ... })，则必须写table.reload('userTable', {...}) - 必须传
where参数，例如：where: { keyword: data.field.keyword }；不传就等于没筛选 - 务必加
page: { curr: 1 }，否则用户在第 5 页搜，结果仍请求第 5 页，大概率为空
搜索后数据没变？先盯住这两个地方
前端传的字段名和后端接口约定不一致，或者没重置页码，是搜索“无效”的两大主因。
- 检查控制台 Network → 请求 URL 的 query string，确认
keyword=xxx是否真实发出；如果没出现，说明where构造失败或事件没触发 - 后端接收的字段名必须和
where键名完全一致（大小写、下划线都不能错），例如前端传{ keyword: "张三" }，后端就得按req.query.keyword或对应 key 取值 - 文本字段建议做
LIKE %value%查询，但记得先trim()和转义，防 SQL 注入；数字字段不能直接LIKE，得用=或范围判断 - 如果用了多个搜索条件（如时间 + 状态下拉），全部塞进同一个
where对象即可，Layui 会自动拼成 query 参数
最容易被忽略的是：搜索框在移动端 iOS Safari 下聚焦时页面缩放，可能把 toolbar 整体顶出视口；上线前务必真机测试，别只靠 Chrome 模拟器。
