直接在laypage.jump回调里写window.scrollTo(0,0)常无效，因DOM重绘异步导致滚动早于渲染完成，需用setTimeout延迟执行；若页面有固定高度容器，则应对该容器而非window滚动。
laypage.jump 回调里 window.scrollTo(0, 0) 不生效？
直接在 jump 回调里写 window.scrollTo(0, 0) 常常无效，因为 Layui 分页点击后 DOM 重绘是异步的，滚动时机早于新内容渲染完成，导致滚到空白处或偏移。
可靠做法是加个微任务延迟，等页面重排完成再滚动：
jump: function(obj, first) {
if (!first) {
// 数据加载完成后滚动
setTimeout(() => {
window.scrollTo({ top: 0, behavior: 'smooth' });
}, 100);
}
}
-
setTimeout比Promise.resolve().then()更稳妥，Layui 内部 DOM 更新不总触发 microtask 队列 - 若容器有固定高度或
overflow: auto，需对容器而非window滚动：document.getElementById('your-container').scrollTop = 0 - 避免用
behavior: 'auto'，iOS Safari 对 smooth 支持不稳定，但无 smooth 时用户感知明显卡顿
table.render 分页跳转时怎么同步置顶？
如果你用的是 table.render()，分页由表格组件托管，jump 回调不在 laypage 配置里，而应在 done 回调中处理置顶逻辑。
done 是表格数据成功渲染后的钩子，此时 DOM 已就绪：
table.render({
elem: '#demo',
url: '/api/list',
page: true,
done: function(res, curr, count) {
// 确保只在翻页时触发（curr 变化），非首次加载
if (curr !== this.page.curr && this.page.curr > 1) {
setTimeout(() => {
document.querySelector('#demo').scrollIntoView({ block: 'start', behavior: 'smooth' });
}, 50);
}
}
});
- 不要依赖
res的结构判断是否翻页，this.page.curr才是当前实际页码 -
scrollIntoView比scrollTop更安全，不依赖容器是否可滚动 - 如果表格嵌在 tab 或折叠面板里，需先确保容器已展开，否则
scrollIntoView会失败
手动跳页输入框触发后怎么置顶？
当用户手动在跳页输入框输入页码并回车，Layui 不会自动触发 jump —— 它只响应点击事件。这个行为容易被忽略，导致置顶逻辑漏掉。
必须监听输入框的 keydown 事件，捕获 Enter 键，并主动触发置顶：
layui.use(['form', 'laypage'], function() {
var form = layui.form;
form.on('submit(laypage-jump)', function(data) {
setTimeout(() => {
window.scrollTo({ top: 0, behavior: 'smooth' });
}, 100);
return false;
});
});
- 跳页表单的 class 默认是
layui-laypage-skip，submit 监听需匹配其内部form的 lay-filter - 若项目禁用了 Layui 表单校验，该监听可能不触发，此时应直接绑定
input[name="jump"]的change或blur事件 - 注意：该方案仅适用于原生 laypage，
table.render的跳页框不走这个 form 流程，得监听.layui-table-page .layui-laypage-skip input
为什么有些页面滚动后又自动回弹？
常见原因是 CSS 中设置了 scroll-behavior: smooth 但同时存在多个滚动容器（如 body + 侧边栏 + 表格容器），Layui 的置顶操作没指定目标，浏览器默认选了错的容器。
根本解法是明确滚动主体：
- 确认主滚动区域是
<body>还是某个<div class="main-content"> - 用
document.documentElement.scrollTop = 0强制 body 滚动（兼容性好） - 若用
scrollIntoView，传入的元素必须是视口内可滚动祖先的 direct child，否则行为不可控 - 某些 UI 框架（如 AdminLTE）会动态添加
overflow-y: hidden到body，需在置顶前临时清除
滚动逻辑本身简单，但真正难的是和现有布局、第三方样式、移动端兼容性缠在一起——每次加置顶，都得重新验证滚动容器是否唯一、是否被遮挡、是否在动画中途被中断。
