獲取頁面滾動位置看似簡單,實則歷經多個瀏覽器時代的 API 變遷:
| API | 支持環境 | 返回值 | 備註 |
|---|---|---|---|
window.pageXOffset / pageYOffset | 現代瀏覽器、IE9+ | 數值 | 標準、唯讀、推薦 |
document.documentElement.scrollLeft/Top | IE6+ (Standards Mode)、現代瀏覽器 | 數值 | 文檔根元素 <html> |
document.body.scrollLeft/Top | IE6- (Quirks Mode)、舊 WebKit | 數值 | <body> 元素 |
window.scrollX / scrollY | 現代瀏覽器 (別名) | 數值 | 等同 pageXOffset/YOffset |
/**
* 獲取頁面滾動距離
* @returns {Array} [xScroll, yScroll]
*/
function getPageScroll() {
var xScroll, yScroll;
// 1. 現代標準:window.pageXOffset/YOffset
if (self.pageYOffset !== undefined) {
yScroll = self.pageYOffset;
xScroll = self.pageXOffset;
}
// 2. IE6+ Standards Mode:documentElement
else if (document.documentElement && document.documentElement.scrollTop !== undefined) {
yScroll = document.documentElement.scrollTop;
xScroll = document.documentElement.scrollLeft;
}
// 3. 兼容模式/舊瀏覽器:body
else if (document.body) {
yScroll = document.body.scrollTop;
xScroll = document.body.scrollLeft;
}
return [xScroll, yScroll];
}
// 一行搞定
const getScroll = () => [window.pageXOffset, window.pageYOffset];
// 或
const getScroll = () => [window.scrollX, window.scrollY];
// 解構賦值使用
const [scrollX, scrollY] = getScroll();
console.log(`水平滾動: ${scrollX}px, 垂直滾動: ${scrollY}px`);
const ScrollUtils = {
/**
* 獲取滾動位置
* @param {Window|Element} target - 目標容器,默認 window
* @returns {{x: number, y: number}}
*/
get: function(target = window) {
if (target === window) {
return {
x: window.pageXOffset || document.documentElement.scrollLeft,
y: window.pageYOffset || document.documentElement.scrollTop
};
}
// 元素滾動
return {
x: target.scrollLeft,
y: target.scrollTop
};
},
/**
* 設置滾動位置(平滑)
*/
set: function(x, y, target = window, behavior = "smooth") {
if (target === window) {
window.scrollTo({ left: x, top: y, behavior });
} else {
target.scrollLeft = x;
target.scrollTop = y;
}
},
/**
* 滾動到元素
*/
scrollToElement: function(selector, target = window, offset = 0) {
const el = typeof selector === "string" ? document.querySelector(selector) : selector;
if (!el) return;
const rect = el.getBoundingClientRect();
const scrollPos = this.get(target);
this.set(
scrollPos.x + rect.left + offset,
scrollPos.y + rect.top + offset,
target
);
},
/**
* 監聽滾動(節流)
*/
onScroll: function(callback, wait = 16, target = window) {
let ticking = false;
target.addEventListener("scroll", function() {
if (!ticking) {
requestAnimationFrame(function() {
callback(ScrollUtils.get(target));
ticking = false;
});
ticking = true;
}
}, { passive: true });
}
};
// 使用
ScrollUtils.onScroll(function(pos) {
console.log("滾動位置:", pos.x, pos.y);
// 導航欄固定、懶加載、視差效果等
});
var lastScrollY = 0;
var navbar = document.getElementById("navbar");
ScrollUtils.onScroll(function(pos) {
if (pos.y > lastScrollY && pos.y > 100) {
// 向下滾動超過 100px:隱藏導航
navbar.classList.add("hidden");
} else {
// 向上滾動或頂部:顯示導航
navbar.classList.remove("hidden");
}
lastScrollY = pos.y;
});
function lazyLoadImages() {
var scrollPos = ScrollUtils.get();
var viewportH = window.innerHeight;
document.querySelectorAll("img[data-src]").forEach(function(img) {
var rect = img.getBoundingClientRect();
// 進入視口前 100px 開始加載
if (rect.top < viewportH + 100 && rect.bottom > -100) {
img.src = img.dataset.src;
img.removeAttribute("data-src");
}
});
}
ScrollUtils.onScroll(lazyLoadImages, 100); // 100ms 節流
function updateReadingProgress() {
var scrollPos = ScrollUtils.get();
var docHeight = document.documentElement.scrollHeight - window.innerHeight;
var progress = (scrollPos.y / docHeight) * 100;
document.getElementById("progressBar").style.width = progress + "%";
}
ScrollUtils.onScroll(updateReadingProgress);
// 同域 iframe
var parentScroll = parent.ScrollUtils.get();
// 或
var parentScroll = { x: parent.pageXOffset, y: parent.pageYOffset };
var container = document.querySelector(".horizontal-scroll");
var scrollX = container.scrollLeft; // 僅元素自身滾動
var doc = document.documentElement;
var body = document.body;
var scrollHeight = Math.max(
doc.scrollHeight, body.scrollHeight,
doc.offsetHeight, body.offsetHeight,
doc.clientHeight, body.clientHeight
);
var clientHeight = doc.clientHeight; // 視口高度
var scrollTop = window.pageYOffset || doc.scrollTop;
獲取滾動距離的現代標準答案是 window.pageXOffset/pageYOffset (或 scrollX/scrollY),配合 document.documentElement.scrollLeft/Top 作為 IE9+ 兼容備選。封裝統一工具模塊,提供獲取、設置、監聽、元素定位等通用能力,並利用 requestAnimationFrame 節流與 passive: true 優化滾動監聽性能。避開 document.body.scrollTop 這類 Quirks 模式殘留,拥抱標準 API。