Layui table渲染时如何自定义请求的参数名-Layui教程-PHP中文网

Layui 2.8 分页参数名默认为 curr/limit，必须显式配置 request 对象以匹配后端字段（如 pageNum/pageSize），且 reload 不自动继承 request，需每次传入；where 与 request 独立，用于业务参数；推荐封装 defaultTableConfig 统一管理。

request对象必须显式声明，不能依赖默认值

layui 2.8 默认发 curr=1 和 limit=10，不是旧版的 page/limit，更不是后端常见的 pagenum/pagesize。不配 request，请求参数名就固定为默认值，后端收不到对应字段。

常见错误是只写 page: true 就以为分页能通——其实只是启用了分页 UI，参数名仍按默认走。

request 必须是对象，字段名严格区分大小写：pageName 不等于 pagename
后端用 Spring Boot？写 request: { pageName: 'pageNum', limitName: 'pageSize' }
后端用 ThinkPHP？写 request: { pageName: 'page', limitName: 'listrows' }
漏配任意一个表格的 request，那个表格的分页请求就会带错参数名

where里传的键名和 request 没关系，别混在一起

where 是额外业务参数，比如搜索条件；request 控制分页参数名。两者互不干扰，但常被误认为“改了 where 就能改 page 名”。

例如你希望后端收到 q_name=张三，那就直接在 where 里写 { q_name: $('#search-name').val() }；这和 request.pageName 完全无关。

where 可以是静态对象（仅首次加载有效），也可以是函数（每次 reload 都重新取值）
函数形式更安全：where: () => ({ q_name: $('#search-name').val().trim() })
静态对象写法容易卡死：where: { q_name: '张三' } —— 输入框改了，这个值不会变
where 里的字段名由你定，后端怎么接就怎么写，不用跟 cols 中的 field 对齐

reload 时必须重传 request，否则沿用初始化配置

table.reload('id', { where: {...} }) 不会自动继承或覆盖 request，它只合并你传入的字段。没传 request，就继续用初始化时那一套。

深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统layui框架模板

下载

这意味着：如果你在初始化时写了 request: { pageName: 'pageNum' }，那后续所有 reload 都默认沿用它；但如果你某次 reload 显式传了 request: { pageName: 'current' }，那这次请求就用 current，之后又恢复原配置。

想保持统一？所有 reload 都不要动 request，只传 where 和 page: { curr: 1 }
想临时换一套分页参数？必须在 reload 里完整传入新的 request 对象
别指望 table.setOptions 能改 request —— 它根本不支持

全局复用 request 的实际做法只有封装函数

Layui 没有 layui.table.setDefaults() 这种接口，所谓“全局配置”只能靠代码层面收敛。

最稳妥的方式是抽一个工厂函数，把通用配置提前定义好，再用 Object.assign 合并个性配置：

const defaultTableConfig = {
  request: { pageName: 'pageNum', limitName: 'pageSize' },
  parseData: res => ({ code: res.code === 0 ? 0 : 1, count: res.total, data: res.list || [] })
};

table.render(Object.assign({
  elem: '#user-table',
  url: '/api/user/list',
  cols: [[{ field: 'name', title: '姓名' }]]
}, defaultTableConfig));

注意 Object.assign 是浅合并，如果某处要覆盖 pageName，得写成 Object.assign({ request: { pageName: 'current' } }, defaultTableConfig)
别把 parseData 写成闭包引用外部变量——它每次执行都是干净作用域
count 字段返回值必须是数字，字符串如 "100" 会导致分页器失效