本文旨在解决网页中“回到顶部”按钮在滚动时无法正确显示的问题。通过分析常见的滚动事件监听误区，特别是当 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 部分应如下所示：
AI建筑知识问答
用人工智能ChatGPT帮你解答所有建筑问题
22 查看详情
$(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 事件监听器中，或将 标签放在 结束标签之前，可以确保元素已存在。在提供的代码中，虽然 scroll-to-top 部分在 $(document).ready() 外部，但由于 使用了 defer 属性，脚本会在 HTML 解析完成后执行，这通常是安全的。
滚动阈值： if (wrapper.scrollTop > 20) 中的 20 是一个示例阈值。您可以根据设计需求调整这个值，例如，如果希望按钮在用户滚动较长距离后才显示，可以将其设置为 250 或更高。
性能优化： 对于频繁触发的滚动事件，可以考虑使用节流 (throttle) 或防抖 (debounce) 技术来限制事件处理函数的执行频率，从而提高页面性能。例如：
// 简单的节流函数示例function throttle(func, delay) { let inThrottle; return function() { const args = arguments; const context = this; if (!inThrottle) { func.apply(context, args); inThrottle = true; setTimeout(() => inThrottle = false, delay); } }}// 应用节流wrapper.addEventListener('scroll', throttle(scrollFunction, 100)); // 每100ms最多执行一次
用户体验：
平滑滚动： behavior: ‘smooth’ 提供了良好的用户体验。按钮样式： 确保“回到顶部”按钮的 z-index 足够高，使其始终位于其他内容之上。在提供的CSS中 z-index: 998 是合适的。可访问性： 为按钮添加 title 属性（如 title=”Gå till toppen”）和 ARIA 属性（如 aria-label=”Scroll to top”）可以提高其可访问性。
通过以上调整，您的“回到顶部”按钮将能够正确检测到 .wrapper 元素的滚动，并在用户向下滚动时按预期显示，从而提供流畅的用户体验。
以上就是解决“回到顶部”按钮在滚动时未显示的问题的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/234609.html
微信扫一扫 
支付宝扫一扫 
