要固定每页条数并隐藏下拉菜单,必须同时设置 page.limits 为空数组且 page.limit 为正整数;limits: [] 是唯一被 layui 识别为彻底隐藏下拉的信号,否则会回退默认选项或渲染无效输入框。

page.limits 设为空数组才能真正隐藏下拉菜单
想让每页条数“固定不动”,本质是禁用用户切换能力,只保留一个确定值。Layui 不提供「禁用下拉」开关,唯一可靠方式是让分页器压根不渲染下拉 DOM —— 这靠 page.limits 控制。limits: [] 是唯一被 Layui 识别为“彻底隐藏”的信号;写成 limits: [15] 或 limits: null 都会 fallback 到默认选项或渲染假输入框。
-
limits: []→ 下拉菜单完全不出现,只显示“15 条/页”文字(前提是limit: 15已设) -
limits: [15]→ 渲染一个带向下箭头但点击无反应的输入框,视觉干扰且易误操作 -
limits缺失或为null→ 自动回退到默认[10, 20, 30, 40, 50],和你的目标完全相反
limit 必须显式写在 page 对象内,且为正整数
即使你只想固定为 20 条,limit: 20 也不能放在 table.render() 的顶层配置里,必须嵌套进 page 子对象中。否则 Layui 完全忽略该配置,静默使用默认 30 条。同时,limit 值不能是字符串(如 "20")、小数或负数,否则同样 fallback 到 30。
- 错误写法:
table.render({ elem: '#demo', url: '/api', limit: 20, page: true })→limit无效 - 正确写法:
table.render({ elem: '#demo', url: '/api', page: { limit: 20, limits: [] } }) - 如果后端接口参数名不是
limit(比如叫pageSize),还得同步配request: { limitName: 'pageSize' },否则请求发出去的仍是limit=20,后端收不到
动态修改固定条数时必须用 table.reload(),不能只改变量
首次渲染后,若业务需要临时切到另一个固定值(比如导出时切到 100 条),不能只改 pageSize 变量再等用户翻页——Layui 不监听变量变化。必须主动触发重载,并把新 limit 显式传入 page 配置。
- 调用方式:
table.reload('demo', { page: { limit: 100 } }) - 注意:reload 不会重置当前页码,仍保持原
curr;如需回到第一页,加page: { limit: 100, curr: 1 } - 别用
table.destroy()+render(),这会丢失排序状态、已绑定事件,且容易引发 DOM 重复
后端必须按 limit 值做数据截取,前端不负责过滤
Layui 表格不会对返回的全部数据做前端分页。它只把 limit 和 curr 当作参数发给后端,由后端计算 (curr - 1) * limit 偏移量并返回对应页的数据。如果后端没按这个逻辑查库,或响应体里 count 字段不是总条数,分页栏就会错乱甚至无法翻页。
- 后端必须接收
page和limit(或你映射后的字段名)两个参数 - SQL 示例:
SELECT * FROM user LIMIT #{(page-1)*limit}, #{limit} - 响应体必须含
count字段(总条数),Layui 用它算总页数;如果后端字段名是total,得用response: { countName: 'total' }映射
真正难的不是写对 limits: [],而是记住:这个空数组必须和 limit 同时存在、同级声明,且后端参数名、偏移计算、总条数字段三者必须严丝合缝——漏一环,UI 就和数据脱节。











