取得滑鼠座標看似簡單,但歷史上 IE 與標準瀏覽器(Firefox、Chrome、Safari)事件物件屬性差異大。本文提供完整跨瀏覽器解決方案,並解析座標系統差異與現代最佳實務。
| 屬性 | 參考點 | 說明 |
|---|---|---|
clientX/Y | 視口左上角 | 不含捲軸位移,所有瀏覽器支援 |
pageX/Y | 文件左上角 | 含捲軸位移,標準瀏覽器支援,IE9+ |
screenX/Y | 螢幕左上角 | 實體螢幕座標,少用 |
offsetX/Y | 目標元素左上角 | 非標準,但廣泛支援 |
function getMousePosition(event) {
event = event || window.event; // IE 相容
var x, y;
// 標準瀏覽器:pageX/Y 直接可用
if (event.pageX !== undefined && event.pageY !== undefined) {
x = event.pageX;
y = event.pageY;
}
// IE 8-:需自行計算捲軸位移
else {
var doc = document.documentElement;
var body = document.body;
x = event.clientX +
(doc && doc.scrollLeft || body && body.scrollLeft || 0) -
(doc && doc.clientLeft || body && body.clientLeft || 0);
y = event.clientY +
(doc && doc.scrollTop || body && body.scrollTop || 0) -
(doc && doc.clientTop || body && body.clientTop || 0);
}
return { x: x, y: y };
}
// 使用範例
document.addEventListener('mousemove', function(e) {
var pos = getMousePosition(e);
document.getElementById('x').textContent = pos.x;
document.getElementById('y').textContent = pos.y;
});
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>滑鼠座標即時顯示</title>
<style>
body { font-family: sans-serif; padding: 20px; }
.coord {
display: inline-block;
width: 80px;
background: #f0f0f0;
padding: 5px 10px;
border-radius: 4px;
font-family: monospace;
}
.label { color: #666; margin-right: 10px; }
</style>
</head>
<body>
<h3>滑鼠座標追蹤</h3>
<p><span class="label">文件座標 (pageX/Y):</span>
X: <span id="pageX" class="coord">0</span>
Y: <span id="pageY" class="coord">0</span>
</p>
<p><span class="label">視口座標 (clientX/Y):</span>
X: <span id="clientX" class="coord">0</span>
Y: <span id="clientY" class="coord">0</span>
</p>
<p><span class="label"gt;螢幕座標 (screenX/Y):</span>
X: <span id="screenX" class="coord">0</span>
Y: <span id="screenY" class="coord">0</span>
</p>
<script>
document.addEventListener('mousemove', function(e) {
document.getElementById('pageX').textContent = e.pageX;
document.getElementById('pageY').textContent = e.pageY;
document.getElementById('clientX').textContent = e.clientX;
document.getElementById('clientY').textContent = e.clientY;
document.getElementById('screenX').textContent = e.screenX;
document.getElementById('screenY').textContent = e.screenY;
});
</script>
</body>
</html>
pageX/YIE11+、Edge、Chrome、Firefox、Safari 全支援 pageX/Y。若無需支援 IE10 以下,程式碼大幅簡化:
document.addEventListener('mousemove', function(e) {
console.log('文件座標:', e.pageX, e.pageY);
console.log('視口座標:', e.clientX, e.clientY);
});
取得滑鼠相對特定元素的位置(如 Canvas 繪圖、拖曳定位):
function getRelativePosition(element, event) {
var rect = element.getBoundingClientRect();
return {
x: event.clientX - rect.left,
y: event.clientY - rect.top
};
}
// 使用
canvas.addEventListener('mousemove', function(e) {
var pos = getRelativePosition(canvas, e);
drawAt(pos.x, pos.y);
});
function getTouchPosition(event) {
var touch = event.touches[0] || event.changedTouches[0];
return {
x: touch.pageX,
y: touch.pageY,
clientX: touch.clientX,
clientY: touch.clientY
};
}
element.addEventListener('touchmove', function(e) {
var pos = getTouchPosition(e);
// 處理觸控移動
}, { passive: true });
mousemove 觸發極頻繁,使用 requestAnimationFrame 或 setTimeout 節流{ passive: true } 提升捲動效能// 節流範例
var ticking = false;
document.addEventListener('mousemove', function(e) {
if (!ticking) {
requestAnimationFrame(function() {
updatePosition(e.pageX, e.pageY);
ticking = false;
});
ticking = true;
}
});
理解 client/page/screen 三種座標系統差異,掌握歷史 IE 相容寫法,現代開發直接使用標準 pageX/Y。配合 getBoundingClientRect() 可輕鬆轉換為元素相對座標,滿足拖曳、繪圖、遊戲等多樣化需求。