直接从 page.layout 数组中移除对应字符串即可隐藏按钮,如小屏仅保留页码和上下翻应设为 ['page', 'prev', 'next'];响应式切换必须通过 table.reload() 显式传入新 page 配置,且应监听表格父容器宽度而非 window。

page.layout 里删掉不需要的项就能隐藏对应按钮
想让「上一页」「跳转框」或「每页数量选择」在小屏消失,不是靠 CSS 隐藏,而是直接从 page.layout 数组里移除对应字符串。Layui 渲染分页栏时,只按 layout 里写的顺序生成 DOM;没写的,压根不创建——没有元素,自然不会占位、不会错乱、reload 也不反弹。
常见按钮对应的 layout 字符串有:'count'(总条数)、'prev'(上一页)、'page'(页码)、'next'(下一页)、'limit'(每页数量)、'refresh'(刷新)、'skip'(跳转输入框)。比如小屏只想留页码和上下翻,就写:layout: ['page', 'prev', 'next']。
- 别写
'skip'→ 跳转框彻底不渲染,比用 CSS 隐藏.layui-laypage-skip干净得多 - 漏掉
'limit'→ 每页数量选择器消失,但page.limit仍生效,服务端分页逻辑不受影响 -
'count'和'refresh'同理:删了就没了,不残留空白或事件绑定
响应式切换 layout 必须 reload,且不能只改 page 对象
不能在 resize 或 ResizeObserver 里只改 table.config.page.layout,那只是内存里的配置,表格 UI 不会变。必须调用 table.reload() 并显式传入新 page 配置,否则等于白操作。
尤其注意:reload 时若未传 page,会沿用初始化时的 layout;所以每次切换都要完整带过去,哪怕其他字段(如 url、where)不变。
- 正确写法:
table.reload('demo', { page: { layout: ['page', 'prev', 'next'] } }) - 错误写法:
table.config.page.layout = [...]; table.reload('demo');→ layout 不更新 - 如果启用了服务端分页,reload 会重新请求数据;不想重复拉,提前缓存
where或加page: { curr: table.config.page.curr }保持当前页码
监听容器宽度而非 window,避免误触发
表格分页栏是否该隐藏按钮,取决于它自己所处容器的宽度,不是整个屏幕。监听 window.resize 在侧边栏展开、弹窗遮挡、地址栏收起时都会误判,导致按钮闪现或错失隐藏时机。
应该监听表格父容器(比如 #demo 的父级 div),用 ResizeObserver 更精准:
const container = document.querySelector('#demo').parentElement;
const ro = new ResizeObserver(() => {
const width = container.clientWidth;
if (width
- 别在
done回调里反复调用 reload,容易因 DOM 尚未就绪导致样式错乱 - 容器需有明确宽度(比如
width: 100%或固定值),否则clientWidth可能为 0 - 移动端 Safari 对 ResizeObserver 支持良好(2026 年已全覆盖),无需降级到 window.resize
隐藏按钮后要注意的两个细节
layout 删掉项是干净的,但仍有两处容易被忽略:
- 某些自定义主题 CSS 可能给
.layui-laypage设了固定height或padding,当按钮减少后,高度没自动收缩,造成底部多出空白——检查 computed 样式,优先删掉这些硬编码尺寸 - 如果用了
page.limits但删了'limit',用户仍可通过 API 调用table.reload({ page: { limit: 50 } })切换每页条数,只是 UI 上不暴露入口;这属于预期行为,不是 bug
真正要小心的是:别把 layout 当成开关数组来回 push/splice,每次 reload 都应传入确定的、完整的新数组,避免状态漂移。











