萬盛學電腦網

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

JavaScript 獲取文檔座標與視口座標完整指南:getBoundingClientRect、scrollOffset、viewportSize

前言

元素位置以像素為單位,向右為 X 軸增加,向下為 Y 軸增加。但有兩個不同的原點:文檔座標(相對文檔左上角)與視口座標(相對瀏覽器可視區域左上角)。本文詳細說明兩者轉換、滾動偏移量獲取、視口尺寸查詢等核心技術。

座標系統對比

  • 文檔座標:不隨滾動改變,較基礎。CSS 定位(position: absolute 等)使用文檔座標。
  • 視口座標:隨滾動改變。getBoundingClientRect() 返回視口座標;滑鼠事件 clientX/clientY 也是視口座標。

若文檔未滾動或小於視口,兩座標系統重合。否則需加減滾動偏移量(scroll offset)互相轉換。

獲取滾動偏移量

function getScrollOffsets(w) {
    w = w || window;
    if (w.pageXOffset != null) { // 現代瀏覽器
        return { x: w.pageXOffset, y: w.pageYOffset };
    }
    var d = w.document;
    if (document.compatMode == "CSS1Compat") { // 標準模式
        return {
            x: d.documentElement.scrollLeft,
            y: d.documentElement.scrollTop
        };
    }
    // 怪異模式
    return { x: d.body.scrollLeft, y: d.body.scrollTop };
}

獲取視口尺寸

function getViewportSize(w) {
    w = w || window;
    if (w.innerWidth != null) { // 現代瀏覽器
        return { w: w.innerWidth, h: w.innerHeight };
    }
    var d = w.document;
    if (document.compatMode == "CSS1Compat") { // 標準模式
        return { w: d.documentElement.clientWidth, h: d.documentElement.clientHeight };
    }
    // 怪異模式
    return { w: d.body.clientWidth, h: d.body.clientHeight };
}

常用屬性速查表

物件屬性說明
windowinnerWidth / innerHeight視口寬/高(含捲軸)
outerWidth / outerHeight整個瀏覽器視窗寬/高
pageXOffset / pageYOffset捲軸位置(標準)
scrollX / scrollY捲軸位置(別名)
document.documentElement / document.bodyclientWidth / clientHeight視口可見內容尺寸(不含捲軸)
offsetWidth / offsetHeight元素佈局尺寸(含邊框、捲軸)
scrollWidth / scrollHeight內容實際尺寸(含溢出部分)
scrollLeft / scrollTop元素捲軸位置

座標轉換實用公式

// 文檔座標 → 視口座標
viewportX = docX - scrollX;
viewportY = docY - scrollY;

// 視口座標 → 文檔座標
docX = viewportX + scrollX;
docY = viewportY + scrollY;

// 獲取元素文檔座標 (利用 getBoundingClientRect)
var rect = el.getBoundingClientRect();
var docX = rect.left + getScrollOffsets().x;
var docY = rect.top + getScrollOffsets().y;

總結

掌握文檔與視口座標系統、滾動偏移量獲取、視口尺寸查詢,是實現拖放、定位、懸浮元素、可視區域檢測等互動功能的基礎。建議封裝通用工具函式庫,統一處理跨瀏覽器與怪異模式差異。

copyright © 萬盛學電腦網 all rights reserved