萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

精準獲取頁面滾動距離:scrollTop 瀏覽器兼容性完整解析

前言

scrollTop 看似簡單,但因瀏覽器渲染模式(標準模式 vs 怪異模式)、文檔結構差異,導致 $('body').scrollTop()、$('html').scrollTop() 表現不一。本文給出跨瀏覽器穩健獲取方案。

問題現象

<!DOCTYPE html> <!-- 標準模式 -->
<html><body><div style="height:2000px">內容</div></body></html>

<script>
// 標準模式下
$('body').scrollTop();   // 0 (Chrome/FF/Safari) 或 非 0 (IE 舊版)
$('html').scrollTop();   // 正確值 (Chrome/FF/Safari)
$(window).scrollTop();   // 正確值 (所有現代瀏覽器)
$(document).scrollTop(); // 正確值 (所有現代瀏覽器)
</script>

根因:滾動容器差異

統一穩健方案

推薦:$(window).scrollTop()

// 獲取當前垂直滾動距離
var scrollTop = $(window).scrollTop();

// 監聽滾動
$(window).on('scroll', function() {
    var st = $(this).scrollTop();
    if (st > 100) $('#backTop').fadeIn();
    else $('#backTop').fadeOut();
});

window 是全局滾動容器的代理,jQuery 內部做了兼容處理,無需關心 html/body 差異。

原生 JS 等價寫法

// 標準模式
var scrollTop = window.pageYOffset || document.documentElement.scrollTop;

// 通用函數
function getScrollTop() {
    return window.pageYOffset !== undefined 
        ? window.pageYOffset 
        : (document.documentElement || document.body).scrollTop;
}

水平滾動 scrollLeft

var scrollLeft = $(window).scrollLeft();
// 原生
var scrollLeft = window.pageXOffset || document.documentElement.scrollLeft;

設置滾動位置

// jQuery 動畫滾動
$('html, body').animate({ scrollTop: 500 }, 300);

// 原生平滑滾動 (現代瀏覽器)
window.scrollTo({ top: 500, behavior: 'smooth' });
// 或指定元素
document.querySelector('#target').scrollIntoView({ behavior: 'smooth' });

常見坑點避雷

  1. 不要用 $('body').scrollTop():標準模式下失效。
  2. iframe 跨域無法獲取父頁滾動:受同源策略限制。
  3. CSS overflow: hidden 影響:容器不滾動則 scrollTop 恆為 0。
  4. 移動端 address bar 隱藏:導致 window.innerHeight 變化,滾動事件觸發頻率不同。

總結

統一使用 $(window).scrollTop() 或原生 window.pageYOffset,拒絕 body/html 選擇器。理解滾動容器機制,配合 scroll 事件節流(requestAnimationFrame / lodash.throttle),構建穩健的滾動交互(回頂部、懶加載、吸頂導航、視差滾動)。

copyright © 萬盛學電腦網 all rights reserved
瀏覽器/模式滾動容器正確選擇器
標準模式 (HTML5)<html> (document.documentElement)$(window) / $(document) / $('html')
怪異模式 (無 DOCTYPE)<body>$('body')
移動端 WebKit視口$(window)