萬盛學電腦網

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

JavaScript 網頁座標與尺寸完整參考手冊

JavaScript 中涉及座標與尺寸的屬性眾多且瀏覽器差異大,本文系統整理 client、offset、scroll、screen 四大系列屬性,並深入分析 DOCTYPE 模式對佈局測量的影響,為前端開發提供權威參考。

四大屬性系列總覽

系列 核心屬性 含義 包含內容
client clientWidth, clientHeight, clientLeft, clientTop 可視區域尺寸 + 內邊距 content + padding (無 border、scrollbar)
offset offsetWidth, offsetHeight, offsetLeft, offsetTop, offsetParent 元素佈局尺寸 + 邊框 content + padding + border (無 margin)
scroll scrollWidth, scrollHeight, scrollLeft, scrollTop 實際內容完整尺寸 + 捲軸位置 content + padding (含溢出內容)
screen screen.width, screen.height, screen.availWidth, screen.availHeight 螢幕/可用工作區尺寸 裝置物理像素 (不含作業系統工具列)

視窗/文檔尺寸關鍵屬性

// 視窗可視區域 (不含捲軸)
window.innerWidth / window.innerHeight     // 標準模式
document.documentElement.clientWidth       // 標準模式 (IE9+)
document.body.clientWidth                  // 相容模式

// 文檔完整尺寸
document.documentElement.scrollWidth       // 標準模式
document.body.scrollWidth                  // 相容模式

// 捲軸位置
window.pageXOffset / window.pageYOffset    // 標準 (IE9+)
document.documentElement.scrollLeft/Top    // 標準模式
document.body.scrollLeft/Top               // 相容模式

事件座標體系完整對照

屬性 參考基準 用途
event.clientX/Y 視窗可視區域左上角 定位浮層、Tooltip、右鍵選單
event.pageX/Y 文檔左上角 (含捲軸) 絕對定位、拖曳計算
event.screenX/Y 螢幕左上角 多螢幕、視窗管理
event.offsetX/Y 目標元素邊框內側左上角 Canvas 繪圖、元素內部定位
event.layerX/Y 當前定位父元素左上角 Firefox 專屬,類似 offsetX

DOCTYPE 模式對尺寸計算的關鍵影響

這是最常被忽略卻導致嚴重 Bug 的根源:

模式 DOCTYPE 宣告 document.documentElement.clientWidth document.body.clientWidth
標準模式 <!DOCTYPE html> 或 XHTML 1.0 Transitional 視窗可視寬度 ✓ body 元素寬度
相容模式 無 DOCTYPE 或舊版 DOCTYPE 0 或異常值 ❌ 視窗可視寬度 (IE)

IE 版本差異詳細表

// IE6-10 標準模式
document.documentElement.clientWidth  // 視窗可視寬度 ✓
document.body.clientWidth             // body 寬度

// IE6-10 相容模式 (Quirks Mode)
document.documentElement.clientWidth  // 0 ❌
document.body.clientWidth             // 視窗可視寬度

// IE5.5 盒模型差異 (相容模式)
clientWidth  = width - border         // 標準是 width + padding
offsetWidth  = width                  // 標準是 width + padding + border

跨瀏覽器通用取值函式庫

var DomUtils = (function() {
  // 獲取視窗可視尺寸
  function getViewport() {
    return {
      width: window.innerWidth || document.documentElement.clientWidth || document.body.clientWidth,
      height: window.innerHeight || document.documentElement.clientHeight || document.body.clientHeight
    };
  }
  
  // 獲取文檔完整尺寸
  function getDocumentSize() {
    var doc = document.documentElement;
    var body = document.body;
    return {
      width: Math.max(doc.scrollWidth, body.scrollWidth, doc.clientWidth, body.clientWidth),
      height: Math.max(doc.scrollHeight, body.scrollHeight, doc.clientHeight, body.clientHeight)
    };
  }
  
  // 獲取捲軸位置
  function getScrollPosition() {
    return {
      x: window.pageXOffset || document.documentElement.scrollLeft || document.body.scrollLeft,
      y: window.pageYOffset || document.documentElement.scrollTop || document.body.scrollTop
    };
  }
  
  // 獲取元素相對文檔位置 (跨瀏覽器)
  function getOffset(el) {
    var rect = el.getBoundingClientRect();
    var scroll = getScrollPosition();
    return {
      top: rect.top + scroll.y,
      left: rect.left + scroll.x,
      width: rect.width,
      height: rect.height
    };
  }
  
  // 獲取元素相對視窗位置
  function getClientRect(el) {
    return el.getBoundingClientRect();
  }
  
  return {
    getViewport: getViewport,
    getDocumentSize: getDocumentSize,
    getScrollPosition: getScrollPosition,
    getOffset: getOffset,
    getClientRect: getClientRect
  };
})();

// 使用範例
console.log('視窗:', DomUtils.getViewport());
console.log('文檔:', DomUtils.getDocumentSize());
console.log('捲軸:', DomUtils.getScrollPosition());
console.log('元素位置:', DomUtils.getOffset(document.getElementById('myDiv')));

實戰應用場景

1. 元素是否在視窗可見區內

function isElementInViewport(el) {
  var rect = el.getBoundingClientRect();
  return (
    rect.top >= 0 &&
    rect.left >= 0 &&
    rect.bottom <= (window.innerHeight || document.documentElement.clientHeight) &&
    rect.right <= (window.innerWidth || document.documentElement.clientWidth)
  );
}

// IntersectionObserver 現代替代方案 (效能更好)
var observer = new IntersectionObserver(function(entries) {
  entries.forEach(function(entry) {
    if (entry.isIntersecting) {
      console.log('元素進入視窗:', entry.target);
    }
  });
});
observer.observe(document.getElementById('watchTarget'));

2. 滾動載入 / 無限滾動

window.addEventListener('scroll', function() {
  var scrollPos = DomUtils.getScrollPosition();
  var docSize = DomUtils.getDocumentSize();
  var vpSize = DomUtils.getViewport();
  
  // 觸發載入閾值:距離底部 200px
  if (scrollPos.y + vpSize.height >= docSize.height - 200) {
    loadMoreData();
  }
}, { passive: true });

3. 固定定位邊界檢測

function updateStickyHeader() {
  var header = document.getElementById('header');
  var scrollY = DomUtils.getScrollPosition().y;
  var headerHeight = header.offsetHeight;
  
  if (scrollY > headerHeight) {
    header.classList.add('fixed');
    document.body.style.paddingTop = headerHeight + 'px'; // 防止內容跳動
  } else {
    header.classList.remove('fixed');
    document.body.style.paddingTop = 0;
  }
}

常見誤區與避坑指南

  1. 混用 body/documentElement:永遠優先使用 document.documentElement (標準模式),並提供 document.body 回退
  2. 忽略 border-box:CSS box-sizing: border-box 不影響 JS 屬性回傳值,offsetWidth 永遠包含 border
  3. zoom/transform 縮放:頁面縮放時 getBoundingClientRect() 回傳縮放後像素,需除以 devicePixelRatio 換算邏輯像素
  4. iframe 跨域:無法存取跨域 iframe 內的 document 尺寸,需用 postMessage 通訊

掌握這套座標體系,能從容應對定位、捲動、響應式佈局、動畫交互等所有幾何計算需求。

copyright © 萬盛學電腦網 all rights reserved