獲取鼠標在頁面/視口/螢幕上的座標是拖拽、提示框定位、畫板等交互基礎。本文系統梳理clientX/Y、pageX/Y、screenX/Y、offsetX/Y、layerX/Y五組座標體系,修正原文scrollLeft/Top兼容性邏輯,提供現代標準化封裝。
| 屬性 | 參考系 | 含義 | 典型用途 |
|---|---|---|---|
clientX/Y | 視口 (可視區) | 鼠標相對瀏覽器窗口左上角 | 固定定位元素定位、懸浮框 |
pageX/Y | 文檔 (整頁) | 鼠標相對文檔左上角 (含滾動) | 絕對定位元素、拖拽、標註 |
screenX/Y | 螢幕 (物理屏) | 鼠標相對顯示器左上角 | 多螢幕、系統級交互 |
offsetX/Y | 目標元素邊框內 | 鼠標相對觸發事件元素padding box左上角 | Canvas繪圖、內部相對定位 |
layerX/Y | 當前佈局層 | 非標準,Firefox/Chrome行為不同 | 避免使用 |
// 原文:document.documentElement.scrollLeft 不兼容 Chrome/舊版 Safari
var scrollLeft = document.documentElement.scrollLeft || document.body.scrollLeft;
var scrollTop = document.documentElement.scrollTop || document.body.scrollTop;
// 現代標準:window.scrollX / scrollY (別名 pageXOffset/pageYOffset)
var scrollLeft = window.scrollX; // 或 window.pageXOffset
var scrollTop = window.scrollY; // 或 window.pageYOffset
// pageX/Y 現代瀏覽器原生支援 (IE9+)
var pageX = event.pageX;
var pageY = event.pageY;
// 兼容性封裝:獲取文檔座標
function getPageCoords(event) {
event = event || window.event;
if (event.pageX != null) { // 現代瀏覽器
return { x: event.pageX, y: event.pageY };
}
// IE8- 降級計算
var doc = document.documentElement;
var body = document.body;
return {
x: event.clientX + (doc.scrollLeft || body.scrollLeft) - (doc.clientLeft || 0),
y: event.clientY + (doc.scrollTop || body.scrollTop) - (doc.clientTop || 0)
};
}
const MouseUtil = {
// 獲取相對文檔座標 (推薦)
getPageXY(event) {
event = event || window.event;
return { x: event.pageX, y: event.pageY };
},
// 獲取相對視口座標
getClientXY(event) {
event = event || window.event;
return { x: event.clientX, y: event.clientY };
},
// 獲取相對元素座標 (需傳入目標元素)
getOffsetXY(event, targetEl) {
const rect = targetEl.getBoundingClientRect();
const client = this.getClientXY(event);
return {
x: client.x - rect.left,
y: client.y - rect.top
};
},
// 綁定移動/點擊統一監聽
bindTracking(handler) {
const moveHandler = (e) => handler(this.getPageXY(e), 'move');
const clickHandler = (e) => handler(this.getPageXY(e), 'click');
document.addEventListener('mousemove', moveHandler, { passive: true });
document.addEventListener('click', clickHandler);
return () => {
document.removeEventListener('mousemove', moveHandler);
document.removeEventListener('click', clickHandler);
};
}
};
// 使用
const unbind = MouseUtil.bindTracking((coords, type) => {
console.log(`${type}:`, coords.x, coords.y);
});
function showTooltip(event, content) {
const { x, y } = MouseUtil.getPageXY(event);
const tooltip = document.getElementById('tooltip');
tooltip.textContent = content;
tooltip.style.left = (x + 10) + 'px';
tooltip.style.top = (y + 10) + 'px';
tooltip.style.display = 'block';
// 防止超出視口右/下邊緣
requestAnimationFrame(() => {
const rect = tooltip.getBoundingClientRect();
const vpW = window.innerWidth, vpH = window.innerHeight;
if (rect.right > vpW) tooltip.style.left = (x - rect.width - 10) + 'px';
if (rect.bottom > vpH) tooltip.style.top = (y - rect.height - 10) + 'px';
});
}
function getTouchCoords(event) {
const touch = event.touches[0] || event.changedTouches[0];
return { x: touch.pageX, y: touch.pageY };
}
// 統一綁定
['mousemove', 'touchmove'].forEach(type =>
document.addEventListener(type, e => handler(getTouchCoords(e)), { passive: true })
);