取得滑鼠位置看似簡單,實際上 JavaScript 提供了五組座標屬性,參照原點各不相同,跨瀏覽器支援度也不一致。用錯屬性,就會出現「在 Chrome 正常、在 IE 卻偏了幾像素」的狀況。本文逐一釐清。

滑鼠相對於顯示器實體螢幕左上角的偏移。這個值不受頁面捲動影響,也不受瀏覽器視窗位置影響,因此適合用於需要與視窗外部坐標對齊的場合。
滑鼠相對於頁面(文件)左上角的偏移,其值不會受捲軸影響——捲到哪裡,同一個元素的 pageY 都不變。
IE9 以下並不支援這個屬性,但可以手動算出來。jQuery 的做法是:
// 當 pageX/Y 缺失但 clientX/Y 可用時補算
if ( event.pageX == null && original.clientX != null ) {
eventDoc = event.target.ownerDocument || document;
doc = eventDoc.documentElement;
body = eventDoc.body;
event.pageX = original.clientX + ( doc && doc.scrollLeft || body && body.scrollLeft || 0 )
- ( doc && doc.clientLeft || body && body.clientLeft || 0 );
event.pageY = original.clientY + ( doc && doc.scrollTop || body && body.scrollTop || 0 )
- ( doc && doc.clientTop || body && body.clientTop || 0 );
}
簡化版就是:滑鼠相對於瀏覽器視口的偏移,加上文件的捲動高度,再減去文件的 clientTop:
var pageY = event.clientY + document.documentElement.scrollTop
- document.documentElement.clientTop;
為什麼要減去 document.documentElement.clientTop?這是 IE8 以下特有的文件偏移,即使把 html 與 body 的 padding 和 margin 都設為 0 也不會改變其值。在 IE7 中實測可得:
document.documentElement.clientTop --> 2px
document.documentElement.clientLeft --> 2px
document.body.clientTop --> 0px
document.body.clientLeft --> 0px
滑鼠相對於瀏覽器視口左上角的偏移。與 pageY 的關鍵差別在於:頁面沒有捲軸時,clientY 的值才等同於 pageY;一旦捲動,兩者就會拉開差距。
如果元素的 position 樣式不是預設的 static,我們就說它具有定位屬性。layerY 的算法是:從觸發滑鼠事件的元素開始往上找祖先,找到最近一個具有定位屬性的元素,以它的 border 左上角外交點作為原點計算偏移。若一路找不到,則改以整個頁面為參照,此時等同於 pageY。

IE9 以下不支援這個屬性,但可以用它特有的 offsetY 替代。
offsetY 與 layerY 有兩個關鍵差異。第一,它的原點是元素 border 左上角的內交點,因此當滑鼠正好停在 border 上時,偏移值會是負數。第二,offsetY 完全不考慮觸發事件的元素是否有定位屬性,它永遠以該元素自身為參照。

因為 layerY 與 offsetY 的原點差了一個 border,要同時兼顧兩邊必須注意兩點:觸發事件的元素一定要設定定位屬性;當元素具有上邊框 border-top 時,layerY 的值會比 offsetY 多出一個 border-top 的寬度。
// element.borderTopWidth 必須是實際計算出的元素上邊框寬度
var borderTopWidth = window.getComputedStyle
? window.getComputedStyle(element, null).borderTopWidth
: element.currentStyle.borderTopWidth;
var offsetY = event.offsetY || (event.layerY + borderTopWidth);
善用 layerY 與 offsetY,就能方便地算出滑鼠相對於綁定事件元素的偏移,這在自訂下拉選單、拖曳排序或 canvas 繪圖命中判斷時特別有用。水平方向的屬性(screenX、pageX、clientX 等)邏輯完全相同,不再贅述。