要做出「回到頂部」浮動按鈕、捲動時改變導覽列樣式,或計算閱讀進度,第一步都是取得目前的捲動距離。麻煩的是各瀏覽器取值的物件不同,以下是一個涵蓋主要情况的通用函式。
/**
* getPageScroll() — 取自 quirksmode.com
* @return Array 回傳含 x、y 捲動值的陣列
*/
function ___getPageScroll() {
var xScroll, yScroll;
if (self.pageYOffset) {
// 多數標準瀏覽器
yScroll = self.pageYOffset;
xScroll = self.pageXOffset;
} else if (document.documentElement && document.documentElement.scrollTop) {
// Explorer 6 Strict Mode
yScroll = document.documentElement.scrollTop;
xScroll = document.documentElement.scrollLeft;
} else if (document.body) {
// 其他 Explorer
yScroll = document.body.scrollTop;
xScroll = document.body.scrollLeft;
}
var arrayPageScroll = new Array(xScroll, yScroll);
return arrayPageScroll;
}
瀏覽器並非只有一套捲動屬性。window.pageYOffset 是標準寫法,絕大多數現代瀏覽器都支援;但在標準模式(Strict Mode)下的舊版 IE,必須改讀 document.documentElement.scrollTop;而在怪異模式(Quirks Mode)下,則要讀 document.body.scrollTop。這個函式依序嘗試,第一個成功的分支就會被採用。
今天已經不必寫得這麼繁瑣。標準屬性可以直接使用:
var scrollTop = window.pageYOffset || document.documentElement.scrollTop;
var scrollLeft = window.pageXOffset || document.documentElement.scrollLeft;
若只是要監聽捲動,也可以搭配 passive 提升效能:
window.addEventListener("scroll", function () {
console.log("目前捲動距離:" + window.scrollY);
}, { passive: true });
其中 window.scrollY 就是 pageYOffset 的別名。需要平滑回到頂部時,window.scrollTo({ top: 0, behavior: "smooth" }) 一行就能取代過去手寫的逐步動畫。