萬盛學電腦網

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

JavaScript 獲取頁面滾動距離:跨瀏覽器兼容的 scrollX/scrollY 獲取方案

核心問題:瀏覽器差異導致的兼容性地獄

獲取頁面滾動位置看似簡單,實則歷經多個瀏覽器時代的 API 變遷:

API支持環境返回值備註
window.pageXOffset / pageYOffset現代瀏覽器、IE9+數值標準、唯讀、推薦
document.documentElement.scrollLeft/TopIE6+ (Standards Mode)、現代瀏覽器數值文檔根元素 <html>
document.body.scrollLeft/TopIE6- (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];
}

現代簡潔寫法(IE9+ / 所有現代瀏覽器)

// 一行搞定
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);
    // 導航欄固定、懶加載、視差效果等
});

實戰場景應用

1. 導航欄滾動固定/隱藏

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;
});

2. 圖片懶加載(IntersectionObserver 更好,但滾動兼容方案)

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 節流

3. 閱讀進度指示器

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 內獲取父頁面滾動

// 同域 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。

copyright © 萬盛學電腦網 all rights reserved