萬盛學電腦網

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

滑鼠事件座標屬性完整對比:screenX/Y、clientX/Y、pageX/Y、layerX/Y、offsetX/Y

座標系統總覽

屬性參考原點受捲動影響瀏覽器支援典型用途
screenX/Y螢幕左上角否全支援多螢幕定位、視窗管理
clientX/Y視口左上角否全支援元素相對視口定位、Tooltip 定位
pageX/Y文檔左上角**是**(含捲動)IE9+拖拽、畫布繪圖、絕對定位
layerX/Y最近定位祖先元素邊框外緣否Firefox/Chrome,IE9- 無相對定位容器內座標
offsetX/Y目標元素邊框內緣(padding 邊界)否IE/Edge/Chrome,Firefox 59+元素內部點擊位置、裁剪區域

視覺化關係圖

螢幕
  └─ 瀏覽器視口
       └─ 文檔(可捲動)
            └─ 定位祖先元素
                 └─ 目標元素
                      ├─ border 外緣 → layerX/Y 參考點
                      ├─ border 內緣 / padding 邊界 → offsetX/Y 參考點
                      └─ content 區域

IE8- 兼容 pageX/Y

function getPageXY(e) {
  e = e || window.event;
  if (e.pageX != null) return { x: e.pageX, y: e.pageY };

  const doc = document.documentElement;
  const body = document.body;
  return {
    x: e.clientX + (doc.scrollLeft || body.scrollLeft) - (doc.clientLeft || body.clientLeft || 0),
    y: e.clientY + (doc.scrollTop || body.scrollTop) - (doc.clientTop || body.clientTop || 0)
  };
}

layerX/Y vs offsetX/Y 關鍵差異

  • layerX/Y:尋找最近的 position !== 'static' 祖先元素,以其 **border 外緣** 為原點。無定位祖先時退回文檔原點(等同 pageX/Y)。
  • offsetX/Y:固定以**觸發事件的目標元素** **border 內緣(padding box)** 為原點。滑鼠在 border 上時值為負數。

跨瀏覽器統一獲取「相對目標元素內部座標」

function getOffsetXY(e, target) {
  target = target || e.target;
  if (e.offsetX != null) return { x: e.offsetX, y: e.offsetY }; // Chrome/IE/Edge

  // Firefox < 59 fallback: layerX + borderTop/Left
  const style = getComputedStyle(target);
  const borderLeft = parseFloat(style.borderLeftWidth) || 0;
  const borderTop = parseFloat(style.borderTopWidth) || 0;
  return { x: e.layerX - borderLeft, y: e.layerY - borderTop };
}

實戰應用場景

  1. 拖拽排序:使用 clientX/Y 計算初始位置,pageX/Y 計算移動距離(含捲動)。
  2. 圖片裁剪/標註:offsetX/Y 直接對應圖片像素座標。
  3. Tooltip / Dropdown 定位:clientX/Y + getBoundingClientRect() 計算彈出層位置。
  4. Canvas/WebGL 互動:offsetX/Y 對應 canvas 內部座標(需扣除 CSS 縮放)。

現代最佳實踐

  • 優先使用 clientX/Y + getBoundingClientRect() 進行幾何計算,不依賴特定事件屬性。
  • 使用 PointerEvent 統一處理滑鼠/觸控/筆輸入,屬性一致性更好。
  • 避免直接使用 layerX/Y、offsetX/Y,除非明確需要相對特定元素的內部座標。
copyright © 萬盛學電腦網 all rights reserved