處理拖曳、 Drawing、氣泡提示這類互動時,座標搞錯就會出現「元素跑位」「拖到一半跳走」的怪現象。問題的根源是:瀏覽器提供了四組座標屬性,參照原點各不相同,而且標準只定義了其中兩組。
測試環境:IETester 6 / 7、IE 8.0、Firefox 3.5.5、Chrome 4.1、Opera 9.64、Safari 4.0。
event.offsetX / offsetY——相對於 srcElement(觸發事件的元素)。取得或設定滑鼠指標相對於觸發事件物件的 x/y 座標。
event.clientX / clientY——總是相對於視口。取得滑鼠指標相對於視窗客戶區的座標,客戶區不含視窗自身的控制項與捲軸。
event.x / y——手冊上說是相對於文件,但在 IE6/7 中,它們的值與 clientX/clientY 一致。這不算嚴重問題,因為「視口相對座標加上捲去的高度」依然能得到真實位置;這個問題在 IE8 的標準模式下被修正了。
event.screenX / screenY——相對於使用者整個螢幕的座標。
event.layerX / layerY——相對於 srcElement,與 IE 的 offsetX 對應。
event.clientX / clientY——相對於視口,與 IE 一致。
event.pageX / pageY——相對於文件(含捲動量),這組是 IE 缺少的。
event.screenX / screenY——相對於螢幕。
這兩位辦事非常周到,收錄了所有屬性:offsetX/Y、layerX/Y、clientX/Y、x/y、pageX/Y。
注意:Chrome 與 Safari 的 event.x / y 表現與 IE6/7 一致,等同於 clientX/clientY。
Opera 堅定地走了 IE6/7 的路線,擁有 offsetX/Y、clientX/Y、x/y,幸好它也有 pageX/Y。
所以完整的結論是:Chrome、Safari、Opera 的 event.x / y 都等同於 clientX/clientY;而在 IE8 中,event.x / y 則等同於其他瀏覽器的 pageX/pageY。同一個屬性名稱,在兩種模式下意義完全不同。
因為 W3C 並沒有標準化這些屬性。DOM Level 3 草案的 MouseEvent 部分沿用了 DOM Level 2 的定義,只有兩對屬性:
clientX / clientY // 相對於事件關聯的視口
screenX / screenY // 相對於螢幕座標系統的原點
於是支持標準的瀏覽器們失去了方向。但瀏覽器廠商轉念一想:W3C 反正遲早要從 offsetXY、layerXY、pageXY、xy 這幾組裡挑一組,於是為了「迎合標準」,乾脆把它們全都放進瀏覽器裡。這就是屬性重複的由來。
var getEventCoord = function (e) {
var evt = e || event;
var html = document.documentElement; // 捲軸在 <HTML> 上
return {
// pageX 為真就用它,否則用 clientX + 捲動量
pageX: evt.pageX || evt.clientX + html.scrollLeft,
pageY: evt.pageY || evt.clientY + html.scrollTop,
clientX: evt.clientX,
clientY: evt.clientY,
layerX: evt.layerX || evt.offsetX,
layerY: evt.layerY || evt.offsetY
};
};
// 用法
document.onmousemove = function (e) {
var coord = getEventCoord(e);
document.title = [coord.pageX, coord.pageY];
};
一、判斷不嚴謹。 evt.pageX || evt.clientX + html.scrollLeft 這種寫法,只要 evt.pageX 等於 undefined、null、NaN、空字串、0、false 中任何一個,左式就為假,於是去算右式。而 evt.pageX 本身是有機會等於 0 的——滑鼠移到文件最左上角時就是 0。這時就會錯誤地加上 scrollLeft。正確判斷是:
typeof evt.pageX == 'number' ? evt.pageX : evt.clientX + html.scrollLeft
二、無法在 quirks mode 下運作。 IE6 為了相容 5.5 之前的版本,引入了兩種渲染模式:怪異模式(Quirks Mode)與標準模式(Standards Mode)。兩者的差異主要集中在 CSS 盒模型的解釋,但在 BOM 層面,捲軸的依賴物件發生了變化:怪異模式中捲軸屬於 body,要取捲動量得用 document.body.scrollTop;標準模式則要用 document.documentElement.scrollTop。
IE6 之後用 document.compatMode 來判斷:BackCompat 表示怪異模式,CSS1Compat 表示標準模式。判斷方式很簡單,看首字母是不是 b:
document.compatMode.indexOf('b') == 0
/^b/i.test(document.compatMode) // 用正則看起來更專業,實際上前者效能略好
var getEventCoord = function (e) {
var evt = e || event,
d = document,
scrollEl = /^b/i.test(d.compatMode) ? d.body : d.documentElement,
supportPage = typeof evt.pageX == 'number',
supportLayer = typeof evt.layerX == 'number';
return {
pageX: supportPage ? evt.pageX : evt.clientX + scrollEl.scrollLeft,
pageY: supportPage ? evt.pageY : evt.clientY + scrollEl.scrollTop,
clientX: evt.clientX,
clientY: evt.clientY,
layerX: supportLayer ? evt.layerX : evt.offsetX,
layerY: supportLayer ? evt.layerY : evt.offsetY
};
};
把 scrollEl 與兩個 typeof 判斷提到 return 之前先算好,是為了避免在物件字面值中重複計算,也讓每個屬性的來源一目了然。
function dragMe(o) {
var supportCapt = !!o.setCapture;
o.onmousedown = function (e) {
var coord = getEventCoord(e),
x = coord.layerX, // 記下按下位置相對元素的偏移
y = coord.layerY;
if (supportCapt) o.setCapture(); // IE 專屬:把滑鼠事件鎖在元素上
document.onmousemove = function (e) {
var coord = getEventCoord(e);
o.style.left = (coord.pageX - x) + 'px';
o.style.top = (coord.pageY - y) + 'px';
};
document.onmouseup = function () {
this.onmousemove = this.onmouseup = null;
if (supportCapt) o.releaseCapture();
};
};
}
dragMe(document.getElementById('block'));
搭配的樣式:
body { font-size: 12px; }
#block {
-moz-user-select: none;
width: 100px; height: 100px;
background: gray; color: white;
line-height: 100px; text-align: center;
}
.move { cursor: move; }
這裡的關鍵是「layerX 減去 pageX」:先記下滑鼠在元素內部的相對位置,拖曳時用當前 pageX 減掉這個偏移,元素才不會在第一次移動時跳到滑鼠底下。這是每個拖曳實作都必須處理的一步。
上面這套分析在今天是歷史資料,但結論仍然有用:
IE 最終放棄了 offsetX/Y、layerX/Y、x/y 這幾套私有實作,改用標準的 clientX/Y、pageX/Y、screenX/Y。因此現代寫法只需要兩行:
document.addEventListener('mousemove', function (e) {
console.log(e.pageX, e.pageY, e.clientX, e.clientY);
});
而拖曳則有更好的答案:Pointer Events 的 setPointerCapture() 取代 IE 專屬的 setCapture(),天生跨滑鼠、觸控與手寫筆,也不必再手動在 document 上掛 mousemove:
block.addEventListener('pointerdown', function (e) {
var startX = e.clientX, startY = e.clientY;
var left = this.offsetLeft, top = this.offsetTop;
this.setPointerCapture(e.pointerId);
this.onpointermove = function (ev) {
this.style.left = (left + ev.clientX - startX) + 'px';
this.style.top = (top + ev.clientY - startY) + 'px';
};
this.onpointerup = function () {
this.onpointermove = this.onpointerup = null;
};
});
理解這段歷史的價值在於:它示範了「瀏覽器差異」這件事的成因(標準缺位 → 各家自行補位 → 屬性名稱碰撞),也示範了正確的應對姿態——不是去記住每個瀏覽器的怪癖,而是用 typeof 檢查能力、用 compatMode 檢查模式、把差異收斂到一個函數裡。這個「收斂到單一入口」的習慣,在任何有環境差異的專案裡都用得上。