獲取滑鼠座標是拖拽、繪圖、提示框定位等互動的基礎。不同瀏覽器、不同事件模型提供的座標屬性眾多,本文系統整理原生 JS 與 jQuery 獲取座標的最佳實踐。
| 屬性 | 參考點 | 含義 | 支援 |
|---|---|---|---|
clientX / clientY | 視口 (viewport) | 相對瀏覽器可視區域左上角,不含滾動 | 所有瀏覽器 |
pageX / pageY | 文檔 (document) | 相對文檔左上角,含滾動距離 | IE9+、標準 |
screenX / screenY | 螢幕 | 相對物理螢幕左上角 | 所有瀏覽器 |
offsetX / offsetY | 目標元素 (target) | 相對觸發事件元素內邊距邊緣 (IE/Chrome) | IE/Chrome/Edge |
layerX / layerY | 目標元素 (currentTarget) | 相對當前監聽元素內邊距邊緣 (Firefox/舊版) | Firefox/Chrome |
function getOffset(e) {
e = e || window.event;
var target = e.target || e.srcElement;
// 優先 offsetX/offsetY (IE/Chrome), 其次 layerX/layerY (Firefox)
var x = e.offsetX !== undefined ? e.offsetX : e.layerX;
var y = e.offsetY !== undefined ? e.offsetY : e.layerY;
return { x: x, y: y, target: target };
}
// 使用
document.getElementById('box').addEventListener('mousemove', function (e) {
var pos = getOffset(e);
console.log('相對 box 座標:', pos.x, pos.y);
});
$('#box').on('mousemove', function (e) {
// jQuery 事件物件統一提供 pageX, pageY, offsetX, offsetY
// offsetX/offsetY 相對當前元素 (currentTarget)
console.log('page:', e.pageX, e.pageY);
console.log('offset:', e.offsetX, e.offsetY);
});
jQuery 內部根據 e.originalEvent 修正 offsetX/Y,開發者可直接使用。
// 原生
function getPageXY(e) {
e = e || window.event;
return {
x: e.pageX !== undefined ? e.pageX : e.clientX + (document.documentElement.scrollLeft || document.body.scrollLeft),
y: e.pageY !== undefined ? e.pageY : e.clientY + (document.documentElement.scrollTop || document.body.scrollTop)
};
}
// jQuery
$('#box').on('click', function (e) {
console.log('文檔座標:', e.pageX, e.pageY); // jQuery 保證 pageX/Y 存在
});
<style>
#tooltip { position: absolute; background: #333; color: #fff; padding: 6px 10px; border-radius: 4px; font-size: 12px; pointer-events: none; z-index: 9999; display: none; }
</style>
<div id="tooltip"></div>
<script>
document.addEventListener('mousemove', function (e) {
var tip = document.getElementById('tooltip');
tip.style.left = (e.pageX + 15) + 'px';
tip.style.top = (e.pageY + 15) + 'px';
tip.textContent = 'X: ' + e.pageX + ', Y: ' + e.pageY;
tip.style.display = 'block';
});
document.addEventListener('mouseout', function (e) {
if (!e.relatedTarget || e.relatedTarget === document.body) {
document.getElementById('tooltip').style.display = 'none';
}
});
</script>
clientX/Y。pageX/Y (jQuery 保證有) 或 clientX/Y + scrollX/Y。offsetX/Y || layerX/Y,jQuery 直接用 offsetX/Y。