layui table 分页跳转框默认不显示,需在 page.layout 数组中显式添加 'jump' 且置于末尾;常见失效原因包括容器宽度不足、总页数≤1 或 css 隐藏。
layui table 分页跳转框默认是否显示
默认不显示。Layui 的 table.render() 初始化后,分页栏右侧的「跳转到第 X 页」输入框是隐藏的,只显示上一页/下一页和页码按钮。
如何开启跳转框:设置 page 配置中的 layout
Layui 分页的显示内容由 page.layout 控制,它是一个数组,决定分页栏里出现哪些组件。跳转框对应的是 'jump' 字符串。
常见错误是只写 page: true 或漏掉 'jump':
- ❌
page: { layout: ['count', 'prev', 'page', 'next', 'limit'] }→ 没有'jump',跳转框不会出现 - ✅
page: { layout: ['count', 'prev', 'page', 'next', 'limit', 'jump'] }→ 跳转框显示在右侧
注意:'jump' 放在 layout 数组末尾,才会出现在分页栏最右边;位置靠前(比如放在 'prev' 后)会导致布局错乱或被截断。
为什么加了 'jump' 还不显示
有三个高频原因:
- 表格容器宽度太窄,Layui 自动隐藏
'jump'区域(尤其在小屏幕或父容器overflow: hidden时) -
page.limit设置过大(比如 1000),总页数 ≤ 1,Layui 认为无需跳转,直接隐藏 - 使用了自定义主题或 CSS 覆盖了
.layui-table-page .layui-laypage-jump样式,比如display: none
验证方法:打开浏览器开发者工具,检查分页容器里是否存在 <div class="layui-laypage-jump"> 元素。没有,说明配置未生效;有但不可见,优先查宽度和 CSS。
<h3>想彻底隐藏跳转框怎么办
</h3>
<p>只要不把 <code>'jump' 写进 page.layout 就行。不需要额外设 false 或其他开关:
page: {
layout: ['count', 'prev', 'page', 'next', 'limit'] // 不含 'jump',就没了
}
如果项目中多个表格要统一行为,建议抽成常量,避免漏写或误加:
const PAGE_LAYOUT_BASIC = ['count', 'prev', 'page', 'next', 'limit']; const PAGE_LAYOUT_WITH_JUMP = [...PAGE_LAYOUT_BASIC, 'jump'];
跳转框看似简单,但它依赖 layout 顺序、容器尺寸、页数计算三者同时满足——少一个,就悄无声息地消失。










