取得滑鼠位置是很多互動效果的第一步——自訂游標、拖曳、畫布作圖、懸浮提示定位都用得到。以下示範原生與 jQuery 兩種寫法,並說明幾個屬性的差異。
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<script src="//ajax.googleapis.com/ajax/libs/jquery/1.8.3/jquery.min.js"></script>
<title>取得滑鼠指標座標</title>
<script>
// 原生 JS
function test(event) {
event = event || window.event;
var x = event.offsetX || event.layerX;
var y = event.offsetY || event.layerY;
alert("x=" + x + "; y=" + y);
}
// jQuery
$(function () {
$("#t").mouseover(function (event) {
event = event || window.event;
var x = event.offsetX || event.originalEvent.layerX;
var y = event.offsetY || event.originalEvent.layerY;
alert("x:" + x + "; y:" + y);
});
});
</script>
</head>
<body>
<div id="t" style="float:left;background-color:green;width:300px;height:60px;">
測試滑鼠位置(jQuery 處理)
</div>
<div id="s" onmouseover="test(event)"
style="float:left;background-color:red;width:300px;height:60px;margin-left:10px;">
測試滑鼠位置(原生 JS 處理)
</div>
</body>
</html>
滑鼠事件物件上其實有好幾組座標,搞混是常見的錯誤來源:
clientX / clientY:相對於視口,不含文件捲動量。這是最常用的一組。pageX / pageY:相對於整個文檔,含捲動量。等於 client 加上 scroll 偏移。screenX / screenY:相對於實體螢幕,多螢幕環境下要注意。offsetX / offsetY:相對於事件目標元素的左上角。上面範例用的就是這組,因為我們要的是「在這個 div 內的相對位置」。layerX / layerY:非標準,Firefox 舊版的替代方案,數值不一定等於 offsetX。範例中的 event.offsetX || event.layerX 是為了相容舊 Firefox。今天已經不需要,直接用 offsetX 即可。
var box = document.getElementById('t');
box.addEventListener('mousemove', function (e) {
// 相對於 box 本身的位置
console.log('offset:', e.offsetX, e.offsetY);
// 相對於視口
console.log('client:', e.clientX, e.clientY);
// 相對於文檔
console.log('page:', e.pageX, e.pageY);
});
用 mousemove 會很卡。滑鼠移動每秒可觸發上百次,若每次都在 handler 裡做重活(大量 DOM 操作、layout 讀取)會明顯掉幀。常見解法是用 requestAnimationFrame 節流:
var ticking = false, lastEvent = null;
box.addEventListener('mousemove', function (e) {
lastEvent = e;
if (!ticking) {
ticking = true;
requestAnimationFrame(function () {
update(lastEvent);
ticking = false;
});
}
});
function update(e) {
// 在這裡做視覺更新
}
offsetX 在不同目標上會變。如果元素內還有子元素,滑鼠移到子元素上時 offsetX 是相對於那個子元素,數值會突然跳掉。需要穩定座標時,改用 clientX - rect.left:
var rect = box.getBoundingClientRect(); var x = e.clientX - rect.left; var y = e.clientY - rect.top;
觸控裝置沒有滑鼠。行動裝置上要改用 touchstart / touchmove,座標在 e.touches[0].clientX;或直接使用 Pointer Events(pointermove),一套 API 同時處理滑鼠、觸控與手寫筆:
box.addEventListener('pointermove', function (e) {
console.log(e.clientX, e.clientY, e.pointerType);
});
另外,範例中用 mouseover 觸發 alert 示範座標,實務上很難用——每次移動都跳一個對話框。若目的只是觀察數值,用 console.log 或把座標寫進頁面元素會實用得多。