Layui表格search: true仅前端过滤,配url后需手动在where中传keyword;select远程搜索需lay-search="{remote:true,url:'...'}"且返回data数组含value/title字段。

search: true 但没反应,先看是不是在远程模式下瞎配
layui 表格的 search: true 默认只做前端过滤,前提是 data 是已加载的数组、且 url 未设置或为 undefined。一旦你配了 url(哪怕只是 url: '/api/list'),Layui 就会忽略本地搜索,每次敲字都重新发 GET 请求——而这个请求根本不会带 keyword 参数,后端自然收不到搜索条件。
常见翻车点:
- 误以为开了
search: true就能搜后端,实际必须手动在where里拼 keyword,或改用table.reload()带参触发 - 用了
page: true却没同步传page和limit,导致后端分页逻辑错乱,返回空数组 - keyword 没做
encodeURIComponent(),含中文时 URL 截断,请求发出去但参数丢了一半
select 远程搜索输完没下拉,检查 lay-search 配置和 request 返回结构
Layui 2.9.16+ 的 select 支持原生远程搜索,但必须写成 lay-search="{ remote: true, url: '/api/options' }"。只写 lay-search 或 lay-search="" 都无效,它只会过滤已有选项,压根不发请求。
request 发出去了但没数据?重点看三点:
- 后端是否真的收到
q=xxx参数(不是keyword或search) - 返回体是否是标准 JSON,且顶层有
data字段(如{"data": [{"value": "1", "title": "北京"}]}),parseData里不能直接return res.data,得包一层{data: res.data} - 后端返回的每项必须含
value和title,缺一个 select 就渲染失败,界面看起来像“没数据”
Network 里看不到请求,大概率是 DOM 没就绪或 url 路径错了
表格或 select 初始化时,如果 elem 对应的节点还没插入 DOM,Layui 会静默失败,控制台可能连警告都没有,表现就是“点了没反应、搜了没数据”。这种情况在 Vue/React 动态挂载、或 JS 写在 HTML head 里时特别常见。
另外,url 写法决定真实请求地址:
-
url: 'api/list'→ 相对于当前页面路径拼接(/admin/user.html下变成/admin/user.html/api/list) -
url: '/api/list'→ 从域名根开始(https://domain.com/api/list) - 漏掉斜杠、多写 .do、Nginx 代理没覆盖该路径,都会导致 404,但 Layui 不报错,只显示空表
打开 Network 面板,筛选 XHR,确认对应请求是否存在;不存在就说明根本没发出去,别急着查后端。
后端返回了数据,但表格还是“No data”,盯死 data 字段类型和字段名
Layui 表格默认从响应体的 data 字段取数组,且要求是真实数组(Array.isArray(res.data) === true)。如果后端返回的是字符串 "[{\"id\":1}]",或者对象 {"list": []} 但没配 response: {dataName: 'list'},就会显示“No data”。
字段名大小写、下划线、短横线也极易出错:
- 后端返回
user_name,但cols里写field: 'userName'→ 取不到值,整行空白 - 字段含短横线如
create-time,field必须写'create-time',取值时用row['create-time'],不能用点号 - 嵌套字段如
user.info.name,Layui 不支持,得用templet函数手动提取
最省事的验证方式:在 done 回调里 console.log(res),一眼看清响应结构、data 类型、第一行原始数据长啥样。


















