layui分页怎么实现点击页码自动回顶部

小杰小哥_7141

小杰小哥_7141

2026-09-30

231人浏览

原创

scrollto(0,0)无效是因为page事件触发过早,dom尚未更新;正确做法是在table.render的done回调中用settimeout延迟执行,滚动目标应为实际滚动容器(如.layui-body),而非window。

layui分页怎么实现点击页码自动回顶部

为什么 page 事件里 scrollTo(0, 0) 没反应

因为 table.on('page(test)') 触发时机太早——用户刚点页码,表格还在发请求、解析数据、重绘 DOM,此时执行 window.scrollTo(0, 0),页面根本没变,滚动自然无效。

常见错误写法:
table.on('page(test)', function(obj){ window.scrollTo(0, 0); });
这个回调里 DOM 还没更新,scrollTo 白执行。

  • page 事件只表示“用户点了”,不保证新内容已渲染
  • 表格重绘完成的唯一可靠钩子是 done 回调
  • 即使写了 done,也要加 setTimeout(..., 0),让浏览器完成 DOM 更新和样式计算

用 table.render 的 done 回调 + setTimeout 滚回顶部

这是最稳的方案,适用于全局滚动(即整个页面上下滚动)。

在 table.render() 配置中加入:

深蓝色网站后台管理系统layui框架模板-AdminPro
深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统layui框架模板

下载
done: function(res, curr, count) {
  setTimeout(() => {
    window.scrollTo(0, 0);
  }, 0);
}
  • 不要用 behavior: 'smooth',Layui 低版本不兼容,且会和分页动画冲突
  • 如果页面实际滚动容器不是 window(比如 .layui-body 设了 overflow-y: auto),就得换目标
  • 检查 computed style:打开开发者工具,选中 .layui-body,看 overflow-y 是否为 auto 或 scroll

表格容器局部滚动时,该滚谁?

很多 Layui 后台布局中,滚动发生在 .layui-body 内部,而不是整个窗口。这时 window.scrollTo 完全无效。

正确做法是操作容器本身:

done: function(res, curr, count) {
  setTimeout(() => {
    const body = document.querySelector('.layui-body');
    if (body) body.scrollTop = 0;
  }, 0);
}
  • 别用 document.documentElement.scrollTop 或 document.body.scrollTop,对 Layui 布局基本不起作用
  • 如果表格启用了 height 配置(如 height: 400),那滚动容器其实是 .layui-table-box,要改成:document.querySelector('.layui-table-box').scrollTop = 0
  • 务必加存在性判断(if (body)),避免控制台报错中断后续逻辑

分页栏里加“回到顶部”按钮怎么塞进去

不能靠 page.layout 或 toolbar 配置,因为分页栏是动态生成的,早期钩子查不到它。

必须在 done 回调里延迟查找并插入:

done: function(res, curr, count) {
  setTimeout(() => {
    const pager = document.querySelector('.layui-table-page .layui-laypage');
    if (!pager || layui.$('.layui-btn-top').length) return;
    
    const btn = document.createElement('button');
    btn.className = 'layui-btn layui-btn-primary layui-btn-sm layui-btn-top';
    btn.innerHTML = '回到顶部';
    btn.onclick = () => {
      const body = document.querySelector('.layui-body');
      if (body) body.scrollTop = 0;
    };
    pager.insertBefore(btn, pager.firstChild);
  }, 10);
}
  • 用 setTimeout(..., 10) 比 0 更可靠,确保分页 DOM 已挂载
  • 插入前必须检查按钮是否已存在,否则搜索、翻页都会重复添加
  • 按钮点击事件必须绑定到 .layui-body,不是 window,这点极易忽略
  • CSS 上可加 .layui-laypage { display: flex; align-items: center; } 防止按钮被挤到下一行
滚动目标错位是这类问题里最隐蔽的一环:你以为在滚页面,其实整个 Layui 布局里真正滚动的是 .layui-body;你以为按钮插进去了,其实它被重复添加了三次却只显示一个——这些细节不验证就写,十次有九次失效。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

layui分页 layui

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2183

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

4663

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

5810

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

5258

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

743

5

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

2026.09.30

0

26

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

2026.09.29

0

15

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

2026.09.23

200

15

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

2026.09.23

120

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
ThinkPHP配置开发与CMS后台实战
ThinkPHP配置开发与CMS后台实战

共87课时 | 12.6万人学习

第二十三期_综合实战
第二十三期_综合实战

共89课时 | 10.8万人学习

Layui 快速入门精讲
Layui 快速入门精讲

共5课时 | 1.6万人学习