座標系統總覽
| 屬性 | 參考原點 | 受捲動影響 | 瀏覽器支援 | 典型用途 |
| screenX/Y | 螢幕左上角 | 否 | 全支援 | 多螢幕定位、視窗管理 |
| clientX/Y | 視口左上角 | 否 | 全支援 | 元素相對視口定位、Tooltip 定位 |
| pageX/Y | 文檔左上角 | **是**(含捲動) | IE9+ | 拖拽、畫布繪圖、絕對定位 |
| layerX/Y | 最近定位祖先元素邊框外緣 | 否 | Firefox/Chrome,IE9- 無 | 相對定位容器內座標 |
| offsetX/Y | 目標元素邊框內緣(padding 邊界) | 否 | IE/Edge/Chrome,Firefox 59+ | 元素內部點擊位置、裁剪區域 |
視覺化關係圖
螢幕
└─ 瀏覽器視口
└─ 文檔(可捲動)
└─ 定位祖先元素
└─ 目標元素
├─ border 外緣 → layerX/Y 參考點
├─ border 內緣 / padding 邊界 → offsetX/Y 參考點
└─ content 區域
IE8- 兼容 pageX/Y
function getPageXY(e) {
e = e || window.event;
if (e.pageX != null) return { x: e.pageX, y: e.pageY };
const doc = document.documentElement;
const body = document.body;
return {
x: e.clientX + (doc.scrollLeft || body.scrollLeft) - (doc.clientLeft || body.clientLeft || 0),
y: e.clientY + (doc.scrollTop || body.scrollTop) - (doc.clientTop || body.clientTop || 0)
};
}
layerX/Y vs offsetX/Y 關鍵差異
- layerX/Y:尋找最近的
position !== 'static' 祖先元素,以其 **border 外緣** 為原點。無定位祖先時退回文檔原點(等同 pageX/Y)。
- offsetX/Y:固定以**觸發事件的目標元素** **border 內緣(padding box)** 為原點。滑鼠在 border 上時值為負數。
跨瀏覽器統一獲取「相對目標元素內部座標」
function getOffsetXY(e, target) {
target = target || e.target;
if (e.offsetX != null) return { x: e.offsetX, y: e.offsetY }; // Chrome/IE/Edge
// Firefox < 59 fallback: layerX + borderTop/Left
const style = getComputedStyle(target);
const borderLeft = parseFloat(style.borderLeftWidth) || 0;
const borderTop = parseFloat(style.borderTopWidth) || 0;
return { x: e.layerX - borderLeft, y: e.layerY - borderTop };
}
實戰應用場景
- 拖拽排序:使用
clientX/Y 計算初始位置,pageX/Y 計算移動距離(含捲動)。
- 圖片裁剪/標註:
offsetX/Y 直接對應圖片像素座標。
- Tooltip / Dropdown 定位:
clientX/Y + getBoundingClientRect() 計算彈出層位置。
- Canvas/WebGL 互動:
offsetX/Y 對應 canvas 內部座標(需扣除 CSS 縮放)。
現代最佳實踐
- 優先使用
clientX/Y + getBoundingClientRect() 進行幾何計算,不依賴特定事件屬性。
- 使用
PointerEvent 統一處理滑鼠/觸控/筆輸入,屬性一致性更好。
- 避免直接使用
layerX/Y、offsetX/Y,除非明確需要相對特定元素的內部座標。