多个搜索框共用一个submit按钮时，必须将所有输入控件置于同一form内并使用form.on('submit(filter)')统一捕获；lay-submit仅适用于按钮，且一个表单只能有一个默认提交行为；字段需有name属性才能进入data.field，日期范围等复合条件应分设name或手动拼接；空值、重复提交、分散dom等情况须在submit回调中手动处理。
多个搜索框共用一个 submit 按钮，必须用 form.on('submit(...)') 统一捕获
直接给每个输入框加 lay-submit 是错的——Layui 的 lay-submit 只绑定在按钮上，且一个表单只能有一个默认提交行为。多个搜索框（比如用户名、状态、日期范围）要共用一个按钮，核心是让所有字段都在同一个 <form></form> 内，并靠 form.on('submit(filterName)') 拿到全部字段值。
- 确保所有输入框（
<input>、<select></select>、<textarea></textarea>）都写在同一个<form class="layui-form" lay-filter="searchForm"></form>里 - 不要给任何输入框加
lay-submit，只给最终的按钮加：<button type="submit" lay-submit lay-filter="searchForm">搜索</button> - 提交时
data.field自动包含所有带name属性的控件值，无需手动收集 - 如果某字段不想提交（如“重置”按钮旁的临时输入），就别设
name，或提交前用delete data.field.xxx删掉
日期范围等复合搜索框需统一 name，避免后端收不到数组
Layui 对 name="dateRange" 这种单 name 多值结构不自动合并。比如你用两个 <input name="dateRange">（开始/结束），data.field.dateRange 默认只取最后一个值。
- 正确做法：给两个输入框分别设
name="startTime"和name="endTime"，后端按字段名接收 - 若坚持用同一 name（如对接旧接口），得手动拼接：
var range = [data.field.startTime, data.field.endTime];，再传给table.reload()的where - 注意：
lay-date绑定的 input 如果没写name，它不会出现在data.field里，必须显式补上
防重复提交和空值过滤得在 submit 回调里做
用户狂点“搜索”按钮，或某些搜索框为空但被提交，都会导致无意义请求。这些逻辑不能靠前端校验属性（如 lay-verify="required"）解决，因为多条件搜索往往允许部分为空。
- 用
layui.$('button[lay-filter="searchForm"]').prop('disabled', true)点击后立即禁用按钮，请求完成再启用 - 清空无效值：
for (let k in data.field) { if (!data.field[k]) delete data.field[k]; } - 特别注意 select 的空选项：
<option value="">全部</option>提交后data.field.status === ""，应主动跳过或转为undefined - 提交前调用
table.reload('yourTableId', { where: data.field })，不是tableIns.reload({ where: ... })，否则 deep 参数可能失效
搜索框分散在不同 DOM 区域时，必须用 form.val() 手动同步
如果搜索条件不在同一个 <form></form> 标签内（比如顶部导航栏一个输入框、侧边栏一个下拉框、表格上方一个日期控件），form.on('submit') 就捕获不到它们。
- 方案一：强行收拢到一个 form —— 用 CSS 定位把各控件视觉上分离，但 DOM 结构仍在 form 内，最稳妥
- 方案二：放弃
form.on，改用按钮 click 监听：layui.$('#searchBtn').on('click', function(){ ... })，然后手动调用form.val('formFilter', {})合并所有字段 - 关键点：
form.val('formFilter', { username: $('#topSearch').val(), status: $('#sidebarSelect').val() })，再拿这个对象去 reload 表格 - 注意：动态生成的搜索框（如弹窗里打开的条件面板），每次打开都要重新绑定事件，不能只初始化一次
name、select 的空选项没过滤、以及分散 DOM 下误信 form.on 能自动收集全量字段。
