event.clientX/Y 返回視口座標,需扣除目標元素相對文檔的偏移量,獲得元素內部相對座標。
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`;
});
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>
getBoundingClientRect 返回變換後矩形,座標自動映射position: fixed 元素相對視口,getBoundingClientRect 同樣適用clientX/Y 不變,getBoundingClientRect 自動更新
// ❌ 錯誤:document.body.scrollLeft 在標準模式下通常為 0
// ✅ 正確:document.documentElement.scrollLeft (標準模式)
// ✅ 現代:window.scrollX / window.scrollY
// ❌ 錯誤:offsetLeft 包含邊框,clientX 不包含
// ✅ 正確:getBoundingClientRect 統一坐標系