本文旨在解决网页中“回到顶部”按钮在滚动时无法正确显示的问题。通过分析常见的滚动事件监听误区，特别是当 body 元素被设置为 overflow: hidden 而实际滚动发生在其他容器时，文章将详细介绍如何使用 window.scrollY 或针对特定滚动容器的 scrollTop 属性来准确检测滚动位置，并提供优化后的 JavaScript 和 CSS 代码示例，确保“回到顶部”功能正常工作。
问题分析：滚动事件与容器溢出
在实现“回到顶部”功能时，一个常见的做法是监听 window 对象的滚动事件，并根据 document.body.scrolltop 或 document.documentelement.scrolltop 的值来判断用户是否向下滚动了足够距离以显示按钮。然而，当网页的 body 或 html 元素被设置 overflow: hidden，而实际可滚动内容位于其内部的某个特定容器（例如，一个设置了 overflow-y: auto 的 div 元素）时，这种方法就会失效。
在提供的代码中，CSS 样式如下：
body { /* ... */ overflow: hidden; /* 关键：阻止body滚动 */ /* ... */}.wrapper { height: 100vh; overflow-y: auto; /* 关键：使wrapper可滚动 */ overflow-x: hidden; perspective: 10px;}
这表明页面的主滚动条实际上并不在 document.body 或 document.documentElement 上，而是在 .wrapper 元素上。因此，document.body.scrollTop 和 document.documentElement.scrollTop 将始终为 0，导致“回到顶部”按钮无法按预期显示。
解决方案：针对特定滚动容器监听
为了解决这个问题，我们需要将滚动事件的监听目标从 window 转移到实际发生滚动的容器元素，即 .wrapper。同时，获取滚动位置的属性也应从 document.body.scrollTop 或 document.documentElement.scrollTop 改为该容器元素的 scrollTop 属性。
步骤一：获取滚动容器元素
首先，在 JavaScript 中获取到 .wrapper 元素。
// 获取滚动容器元素const wrapper = document.querySelector('.wrapper');const scrollButton = document.getElementById('scroll-button'); // 假设按钮ID为scroll-button
步骤二：监听容器的滚动事件
将 window.onscroll 替换为 wrapper.addEventListener(‘scroll’, …)。
// 监听wrapper元素的滚动事件wrapper.addEventListener('scroll', scrollFunction);function scrollFunction() { // 使用wrapper.scrollTop来获取滚动位置 if (wrapper.scrollTop > 20) { // 20px是示例阈值，可根据需要调整 scrollButton.style.display = 'block'; } else { scrollButton.style.display = 'none'; }}
步骤三：修改回到顶部功能
“回到顶部”的功能也需要调整，使其将 .wrapper 元素滚动到顶部。
scrollButton.addEventListener('click', topFunction);function topFunction() { // 将wrapper元素滚动到顶部 wrapper.scrollTo({ top: 0, left: 0, behavior: 'smooth' // 平滑滚动效果 });}
完整优化后的JavaScript代码
结合以上修改，JavaScript 部分应如下所示：
$(document).ready(function () { // Hamburger and Dark-Light switcher related code (unchanged) $(".burger-container").click(function () { $(".nav-menu").toggleClass("menu-opened"); $("body").toggleClass("unscrollable"); }); $("body").toggleClass("light", localStorage.toggled == "light"); document.getElementById("checkBox").addEventListener("click", darkLight); function darkLight() { if (localStorage.toggled != "light") { $("body").toggleClass("light", true); localStorage.toggled = "light"; } else { $("body").toggleClass("light", false); localStorage.toggled = ""; } } if ($("body").hasClass("light")) { $("#checkBox").prop("checked", true); } else { $("#checkBox").prop("checked", false); }});// Scroll to top functionality (Optimized)const wrapper = document.querySelector('.wrapper'); // 获取实际的滚动容器const scrollButton = document.getElementById('scroll-button'); // 获取回到顶部按钮// 确保wrapper元素存在if (wrapper && scrollButton) { // 监听wrapper元素的滚动事件 wrapper.addEventListener('scroll', function() { // 根据wrapper的scrollTop属性判断是否显示按钮 if (wrapper.scrollTop > 20) { // 当滚动距离超过20px时显示按钮 scrollButton.style.display = 'block'; } else { scrollButton.style.display = 'none'; } }); // 按钮点击事件：将wrapper滚动到顶部 scrollButton.addEventListener('click', function() { wrapper.scrollTo({ top: 0, left: 0, behavior: 'smooth' // 平滑滚动 }); });} else { console.warn("Wrapper or scroll-button element not found. Scroll-to-top functionality may not work.");}
注意事项与最佳实践
DOM加载顺序： 确保在尝试获取 wrapper 和 scrollButton 元素之前，DOM 已经完全加载。将相关 JavaScript 代码放在 DOMContentLoaded 事件监听器中，或将 标签放在
以上就是解决“回到顶部”按钮在滚动时未显示的问题的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1514336.html
微信扫一扫 
支付宝扫一扫 
![Win10与Ubuntu 18.04双系统安装。（Win10引导Linux）[通俗易懂]](https://www.chuangxiangniao.com/wp-content/uploads/2025/10/175254039529565.jpg)
![Win10与Ubuntu 18.04双系统安装。（Win10引导Linux）[通俗易懂]](https://www.chuangxiangniao.com/wp-content/uploads/2025/10/175254039878675.jpg)
![Win10与Ubuntu 18.04双系统安装。（Win10引导Linux）[通俗易懂]](https://www.chuangxiangniao.com/wp-content/uploads/2025/10/175254039840102.jpg)
![Win10与Ubuntu 18.04双系统安装。（Win10引导Linux）[通俗易懂]](https://www.chuangxiangniao.com/wp-content/uploads/2025/10/175254040055572.jpg)
