獲取頁面捲動距離 scrollTop 是前端高頻需求,但歷史上因瀏覽器模式(Quirks/Standards)、文件結構差異導致相容性極差。本文深度解析經典相容寫法的原理、現代標準 API、效能優化與框架整合模式。
function getScrollTop() {
return document.documentElement.scrollTop
|| window.pageYOffset
|| document.body.scrollTop
|| 0;
}
document.documentElement.scrollTop:標準模式下 <html> 為捲動容器(現代瀏覽器、IE Standards Mode)window.pageYOffset:標準屬性,Safari 早期唯一支援,現代瀏覽器皆支援,值為 0 時不會誤判為 falsy(關鍵!)document.body.scrollTop:Quirks 模式或舊版 IE 捲動容器為 <body>|| 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。
// 視窗捲動距離(含視覺視口縮放)
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;
// ❌ 直接綁定 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'));
// 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; });
// 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,即可在任何專案中安心複用。