laypage.render 的 elem 参数需传 ID 字符串(如'pagination')或 DOM 对象,不可带#号;jump 回调须用 !first 判断避免重复请求;移动端需放大分页热区至44px;table 分页应调用 table.reload() 而非 laypage.render()。

laypage.render 的 elem 参数别带 # 号
移动端报 Uncaught TypeError: Cannot read property 'innerHTML' of null,八成是这里错了。laypage 只接受 ID 字符串(不带 #)或 DOM 对象,传 '#pagination' 就会去查 document.getElementById('#pagination'),结果当然是 null。
正确写法只有两种:
-
elem: 'pagination'(推荐,简洁) -
elem: document.getElementById('pagination')(适合动态创建容器的场景)
别图省事加 #,这个错误在手机调试时尤其隐蔽——页面可能白屏或分页区直接消失,但控制台提示被折叠,容易漏看。
jump 回调里必须判断 !first
移动端用户点“下一页”或输页码回车,jump 都会触发。但 laypage 初始化时会自动调一次 jump(first === true),如果你没拦住,就会在第 1 页还没显示完时就发第二次请求,造成数据重复、loading 状态错乱、甚至接口限流被触发。
安全写法是:
jump: function(obj, first) {
if (!first) {
// 这里发起 AJAX,用 obj.curr 和 obj.limit
}
}注意:不要用全局变量存当前页码再比对,first 是 laypage 唯一可靠的初始化标识。
移动端分页按钮热区太小,得手动放大
laypage 默认按钮高度约 28px,iOS/Android 触摸最小建议热区是 44px × 44px。不改的话,用户反复点不中、误触上一页、或者点开键盘挡住分页栏,都是高频问题。
用媒体查询覆盖样式,重点改三处:
-
.layui-laypage a和.layui-laypage span的height和line-height设为44px -
.layui-laypage .layui-laypage-prev, .layui-laypage .layui-laypage-next加padding: 0 12px防止文字被截 -
@media (max-width: 768px)范围内把字体设为15px,避免缩放后文字糊成一团
别只改 font-size,热区大小才是点击成功率的关键。
table 内置分页优先用 table.reload() 跳页
如果你的分页是通过 table.render({ page: true }) 启用的,就别碰底层 laypage.render()。table 组件自己管理分页状态,直接调 laypage.render() 会导致页码 UI 和表格数据不同步——比如 UI 显示第 3 页,实际加载的还是第 1 页数据。
跳转指定页的正解是:
table.reload('yourTableId', {
page: {
curr: 5
}
});其中 'yourTableId' 是你初始化时传的 id 字符串(不是 DOM ID,也不是 lay-id)。漏掉这个字符串,reload 就找不到目标实例,静默失败,毫无提示。
这是移动端最易忽略的一环:开发者习惯性去操作 laypage 实例,却忘了 table 已经封装了一层状态同步逻辑。


















