萬盛學電腦網

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

JavaScript 獲取滑鼠在 DIV 內相對座標:offsetLeft/Top 遞歸累加法詳解

核心問題

event.clientX/Y 返回視口座標,需扣除目標元素相對文檔的偏移量,獲得元素內部相對座標。

標準實現:遞歸累加 offsetParent


function getElementPosition(element) {
  let left = 0, top = 0;
  let current = element;
  
  do {
    left += current.offsetLeft;
    top += current.offsetTop;
    current = current.offsetParent;
  } while (current);
  
  return { left, top };
}

// 使用示例
document.getElementById('demo').addEventListener('mousemove', (e) => {
  const pos = getElementPosition(e.currentTarget);
  const relX = e.clientX - pos.left + document.documentElement.scrollLeft;
  const relY = e.clientY - pos.top + document.documentElement.scrollTop;
  
  document.getElementById('mp_x').textContent = `${relX}px`;
  document.getElementById('mp_y').textContent = `${relY}px`;
});

現代優化 API:getBoundingClientRect()


function getRelativePosition(element, event) {
  const rect = element.getBoundingClientRect();
  // rect 已包含滾動偏移,直接使用 clientX/Y 相減
  return {
    x: event.clientX - rect.left,
    y: event.clientY - rect.top
  };
}

// 使用
demo.addEventListener('mousemove', (e) => {
  const { x, y } = getRelativePosition(demo, e);
  mp_x.textContent = `${Math.round(x)}px`;
  mp_y.textContent = `${Math.round(y)}px`;
});

優勢:原生 C++ 實現、自動處理邊框、滾動、transform、CSS 偏移、性能極佳。

完整可運行示例


<!DOCTYPE html>
<html>
<head>
  <style>
    #demo {
      width: 300px; height: 300px;
      background: #000; color: #0011ff;
      position: absolute; top: 80px; left: 90px;
      border: 2px solid #333; /* 邊框影響 offset 但不影響 getBoundingClientRect */
    }
    #coords { margin-top: 400px; font-family: monospace; }
  </style>
</head>
<body>
  <div id="demo">移動滑鼠顯示相對座標</div>
  <div id="coords">X: <span id="mp_x">0</span> Y: <span id="mp_y">0</span></div>
  
  <script>
    const demo = document.getElementById('demo');
    const mp_x = document.getElementById('mp_x');
    const mp_y = document.getElementById('mp_y');
    
    demo.addEventListener('mousemove', (e) => {
      const rect = demo.getBoundingClientRect();
      mp_x.textContent = Math.round(e.clientX - rect.left);
      mp_y.textContent = Math.round(e.clientY - rect.top);
    });
  </script>
</body>
</html>

邊界情況處理

  • Transform 縮放/旋轉:getBoundingClientRect 返回變換後矩形,座標自動映射
  • iframe 跨域:無法獲取父頁面座標,需 postMessage 通信
  • 固定定位:position: fixed 元素相對視口,getBoundingClientRect 同樣適用
  • 滾動容器:容器滾動時 clientX/Y 不變,getBoundingClientRect 自動更新

常見誤區修正


// ❌ 錯誤:document.body.scrollLeft 在標準模式下通常為 0
// ✅ 正確:document.documentElement.scrollLeft (標準模式)
// ✅ 現代:window.scrollX / window.scrollY

// ❌ 錯誤:offsetLeft 包含邊框,clientX 不包含
// ✅ 正確:getBoundingClientRect 統一坐標系
copyright © 萬盛學電腦網 all rights reserved