萬盛學電腦網

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

JavaScript 獲取 scrollTop 跨瀏覽器完美相容寫法:原理、陷阱與現代替代方案

獲取頁面捲動距離 scrollTop 是前端高頻需求,但歷史上因瀏覽器模式(Quirks/Standards)、文件結構差異導致相容性極差。本文深度解析經典相容寫法的原理、現代標準 API、效能優化與框架整合模式。

經典相容寫法(IE6+ 至現代瀏覽器)


function getScrollTop() {
  return document.documentElement.scrollTop 
      || window.pageYOffset 
      || document.body.scrollTop 
      || 0;
}

為什麼要這個順序?

  1. document.documentElement.scrollTop:標準模式下 <html> 為捲動容器(現代瀏覽器、IE Standards Mode)
  2. window.pageYOffset:標準屬性,Safari 早期唯一支援,現代瀏覽器皆支援,值為 0 時不會誤判為 falsy(關鍵!)
  3. document.body.scrollTop:Quirks 模式或舊版 IE 捲動容器為 <body>
  4. || 0:最終防禦,確保回傳數字

關鍵陷阱:0 || undefined === undefined


// 錯誤順序:pageYOffset 放最後
const bad = document.documentElement.scrollTop || document.body.scrollTop || window.pageYOffset;
// 當頁面在最頂端:scrollTop=0, pageYOffset=0(但舊 Safari 回傳 undefined)
// 0 || 0 || undefined => undefined ❌

// 正確順序:pageYOffset 放中間
const good = document.documentElement.scrollTop || window.pageYOffset || document.body.scrollTop;
// 0 || 0 || 0 => 0 ✅

原理:JavaScript || 運算子遇到 0 會繼續往後找,但 undefined 也是 falsy。舊版 Safari pageYOffset 回傳 undefined,若放在最後會「吃掉」前面的 0。放在中間時,前面若為 0 會繼續評估 pageYOffset(此時現代瀏覽器回傳 0),最後才落回 body.scrollTop。

現代標準 API(推薦優先使用)


// 視窗捲動距離(含視覺視口縮放)
const scrollY = window.scrollY; // 等同 pageYOffset,別名
const scrollX = window.scrollX; // 水平捲動

// 元素捲動距離
const elScrollTop = element.scrollTop;
const elScrollLeft = element.scrollLeft;

// 捲動至指定位置(支援平滑動畫)
window.scrollTo({ top: 100, behavior: 'smooth' });
element.scrollTo({ top: 0, behavior: 'smooth' });

// 獲取元素相對視窗位置
const rect = element.getBoundingClientRect();
const viewportTop = rect.top + window.scrollY;

效能優化:被動事件監聽器 + requestAnimationFrame


// ❌ 直接綁定 scroll 會阻塞主執行緒
window.addEventListener('scroll', onScroll);

// ✅ 被動監聽器(瀏覽器可繼續捲動不等待 handler)
window.addEventListener('scroll', onScroll, { passive: true });

// ✅ 配合 rAF 節流,確保 60fps
let ticking = false;
function onScroll() {
  if (!ticking) {
    requestAnimationFrame(() => {
      // 實際處理邏輯
      const scrollTop = getScrollTop();
      updateUI(scrollTop);
      ticking = false;
    });
    ticking = true;
  }
}

// ✅ IntersectionObserver 替代 scroll 監聽(曝光檢測、懶載入、無限滾動)
const observer = new IntersectionObserver(entries => {
  entries.forEach(entry => entry.isIntersecting && loadMore());
}, { rootMargin: '200px' });
observer.observe(document.querySelector('#sentinel'));

框架整合模式

Vue 3 Composable


// useScrollTop.js
import { ref, onMounted, onUnmounted } from 'vue';

export function useScrollTop() {
  const scrollTop = ref(0);
  let ticking = false;
  
  const update = () => {
    scrollTop.value = window.scrollY || document.documentElement.scrollTop || document.body.scrollTop;
    ticking = false;
  };
  
  const handler = () => {
    if (!ticking) { requestAnimationFrame(update); ticking = true; }
  };
  
  onMounted(() => window.addEventListener('scroll', handler, { passive: true }));
  onUnmounted(() => window.removeEventListener('scroll', handler));
  
  return scrollTop;
}

// 組件中
const scrollTop = useScrollTop();
watch(scrollTop, (v) => { if (v > 200) showBackTop.value = true; });

React Hook


// useScrollTop.js
import { useState, useEffect } from 'react';

export function useScrollTop() {
  const [scrollTop, setScrollTop] = useState(0);
  useEffect(() => {
    let ticking = false;
    const handler = () => {
      if (!ticking) {
        requestAnimationFrame(() => {
          setScrollTop(window.scrollY || document.documentElement.scrollTop || document.body.scrollTop);
          ticking = false;
        });
        ticking = true;
      }
    };
    window.addEventListener('scroll', handler, { passive: true });
    return () => window.removeEventListener('scroll', handler);
  }, []);
  return scrollTop;
}

總結:選擇指南

場景推薦寫法
現代專案(無 IE 需求)window.scrollY / window.scrollTo({behavior:'smooth'})
需支援 IE11 / 舊專案維護經典相容函式 getScrollTop()
元素內部捲動element.scrollTop / element.scrollTo()
高頻響應(導航隱藏、視差)passive: true + requestAnimationFrame
曝光/懶載入/無限滾動IntersectionObserver
框架專案封裝為 Composable / Hook 複用

結語

「document.documentElement.scrollTop || window.pageYOffset || document.body.scrollTop」這行經典代碼見證了前端相容性演進。現代開發應優先使用 window.scrollY、scrollTo({behavior:'smooth'})、IntersectionObserver 等標準 API,並務必加上 passive: true 與 requestAnimationFrame 節流。將邏輯封裝為框架無關的工具函數或 Composable/Hook,即可在任何專案中安心複用。

copyright © 萬盛學電腦網 all rights reserved