在拖曳互動、遊戲開發、滑鼠追蹤特效、座標標註等場景,精準獲取滑鼠座標是基礎能力。本文詳解各種座標體系、跨瀏覽器相容計算,並提供可直接執行的即時顯示 Demo 程式碼。
| 屬性 | 參考基準 | 含捲動 | 適用場景 |
|---|---|---|---|
event.clientX / clientY | 視窗可視區左上角 | 否 | 定位浮層、Tooltip、相對視窗定位 |
event.pageX / pageY | 文件左上角 | 是 | 拖曳、繪圖、元素絕對定位 |
event.screenX / screenY | 螢幕左上角 | 否 | 多視窗協作、全螢幕遊戲 |
event.offsetX / offsetY | 目標元素邊框內側左上角 | 否 | Canvas 繪圖、元素內部相對定位 |
event.layerX / layerY | 當前元素左上角(非標準) | 否 | 舊版 Firefox/Gecko 專用 |
現代瀏覽器(IE9+、所有現代瀏覽器)原生支援 event.pageX/Y。若需支援 IE8 及以下,需手動計算:
/**
* 統一獲取滑鼠相對文件座標 (pageX, pageY)
* @param {Event} e - 事件對象
* @returns {{x: number, y: number}}
*/
function getMousePos(e) {
e = e || window.event; // IE 相容
var x = e.pageX;
var y = e.pageY;
// IE8- 不支援 pageX/Y,需手動計算
if (x === undefined || y === undefined) {
var docEl = document.documentElement;
var body = document.body;
x = e.clientX + (docEl.scrollLeft || body.scrollLeft) - (docEl.clientLeft || 0);
y = e.clientY + (docEl.scrollTop || body.scrollTop) - (docEl.clientTop || 0);
}
return { x: x, y: y };
}
// 使用範例
document.addEventListener('mousemove', function (e) {
var pos = getMousePos(e);
console.log('滑鼠文件座標:', pos.x, pos.y);
// 即時更新 UI 元素位置 ...
});
<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>滑鼠座標即時顯示</title>
<style>
body { font-family: sans-serif; padding: 20px; }
.coord-box { display: inline-block; width: 220px; padding: 10px; margin: 5px; background: #f0f0f0; border: 1px solid #ccc; border-radius: 4px; }
.coord-label { font-weight: bold; color: #333; }
.coord-value { font-family: monospace; color: #0066cc; }
#track-area { width: 100%; height: 300px; background: #e8f4fd; border: 2px dashed #3a7bd5; margin-top: 20px; position: relative; }
#cursor-display { position: absolute; top: 10px; left: 10px; background: rgba(0,0,0,0.7); color: #fff; padding: 5px 10px; border-radius: 3px; font-size: 12px; pointer-events: none; }
</style></head><body>
<h2>即時滑鼠座標(在下方藍色區域移動滑鼠)</h2>
<div class="coord-box">
<div class="coord-label">clientX / clientY (視窗)</div>
<div class="coord-value" id="d-client">0, 0</div>
</div>
<div class="coord-box">
<div class="coord-label">pageX / pageY (文件)</div>
<div class="coord-value" id="d-page">0, 0</div>
</div>
<div class="coord-box">
<div class="coord-label">screenX / screenY (螢幕)</div>
<div class="coord-value" id="d-screen">0, 0</div>
</div>
<div class="coord-box">
<div class="coord-label">offsetX / offsetY (目標元素)</div>
<div class="coord-value" id="d-offset">0, 0</div>
</div>
<div id="track-area">
<div id="cursor-display">滑鼠座標</div>
</div>
<script>
var trackArea = document.getElementById('track-area');
var display = document.getElementById('cursor-display');
trackArea.addEventListener('mousemove', function (e) {
// 1. 視窗座標
document.getElementById('d-client').textContent = e.clientX + ', ' + e.clientY;
// 2. 文件座標 (pageX/Y 現代瀏覽器原生支援)
document.getElementById('d-page').textContent = e.pageX + ', ' + e.pageY;
// 3. 螢幕座標
document.getElementById('d-screen').textContent = e.screenX + ', ' + e.screenY;
// 4. 目標元素內部座標
document.getElementById('d-offset').textContent = e.offsetX + ', ' + e.offsetY;
// 5. 更新跟隨顯示框
display.style.left = e.offsetX + 15 + 'px';
display.style.top = e.offsetY + 15 + 'px';
display.textContent = 'client: ' + e.clientX + ',' + e.clientY
+ ' | page: ' + e.pageX + ',' + e.pageY;
});
</script>
</body></html>
var isDragging = false, startX, startY, elX, elY;
$('#draggable').on('mousedown', function (e) {
isDragging = true;
startX = e.pageX; startY = e.pageY;
elX = parseInt($(this).css('left'), 10) || 0;
elY = parseInt($(this).css('top'), 10) || 0;
$(document).on('mousemove.drag', onDrag).on('mouseup.drag', onDragEnd);
});
function onDrag(e) {
if (!isDragging) return;
$('#draggable').css({
left: elX + (e.pageX - startX),
top: elY + (e.pageY - startY)
});
}
function onDragEnd() {
isDragging = false;
$(document).off('.drag');
}
canvas.addEventListener('mousemove', function (e) {
var ctx = canvas.getContext('2d');
var x = e.offsetX, y = e.offsetY;
// 繪製邏輯 ...
});
function showTooltipAtMouse(e, text) {
var x = e.clientX + 10;
var y = e.clientY + 10;
$tooltip.css({ left: x, top: y }).text(text).show();
}
function getTouchPos(e) {
var touch = e.touches[0] || e.changedTouches[0];
return {
clientX: touch.clientX,
clientY: touch.clientY,
pageX: touch.pageX,
pageY: touch.pageY,
screenX: touch.screenX,
screenY: touch.screenY
};
}
element.addEventListener('touchmove', function (e) {
var pos = getTouchPos(e);
// 同樣邏輯處理 ...
}, { passive: true });
mousemove 事件極高頻,處理函式務必極簡(避免重排、複雜計算)。requestAnimationFrame 或 setTimeout 降低 UI 更新頻率。pointermove (Pointer Events)。掌握座標體系與相容寫法,您就能自信處理所有滑鼠/觸控互動開發需求。