HOWTO · JavaScript
在 JavaScript 中跟蹤滑鼠位置
在本教程中,我們將瞭解如何在 JavaScript 中使用滑鼠事件跟蹤滑鼠位置。
本頁內容
在瀏覽器中註冊 mousemove 事件的回呼,即可追蹤指標移動。回呼會收到 MouseEvent;請直接讀取該事件的座標屬性,不必另外保存指標狀態。指標在視窗內移動時,這個事件會觸發,讓處理函式每次都能取得最新位置。
使用 mousemove 事件監聽滑鼠移動
事件監聽器會指定事件類型和回呼函式。在下方的瀏覽器範例中,window.addEventListener 會為 mousemove 註冊 handleMouseMove,而回呼會讀取 pageX、pageY、clientX 和 clientY。這些屬性名稱區分大小寫。mousemove 事件會回報指標移動;網頁載入或指標靜止時,它不會觸發。
簡短的可執行範例示範回呼如何格式化事件值。其中的純物件只是用來說明屬性名稱的範例輸入;在互動式網頁中,請使用真正的瀏覽器 MouseEvent。
執行此範例:
本節中的程式碼以及顯示的標籤或輸出仍為英文。
function handleMouseMove(event) {
console.log(
`page: (${event.pageX}, ${event.pageY}); client: (${event.clientX}, ${event.clientY})`
);
}
handleMouseMove({ pageX: 120, pageY: 240, clientX: 120, clientY: 240 });
若要在瀏覽器中互動,請使用這個自包含頁面。頁面內容足夠長,因此可以捲動;指標在頁面上移動時,處理函式會記錄兩組座標。
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Mouse coordinates</title>
<style>
body { min-height: 1600px; font: 16px sans-serif; }
main { padding: 2rem; }
</style>
</head>
<body>
<main>
<h1>Move the pointer, then scroll</h1>
<p>Open the browser developer console to compare the coordinate pairs.</p>
</main>
<script>
window.addEventListener('mousemove', (event) => {
console.log(
`page: (${event.pageX}, ${event.pageY}); client: (${event.clientX}, ${event.clientY})`
);
});
</script>
</body>
</html>
選擇頁面座標或視埠座標
pageX 和 pageY 會以文件左上角為原點測量指標位置。它們包含文件的捲動偏移量,因此適合用於位置必須隨內容而定的情況,例如記錄長篇文件中某個點的位置。
clientX 和 clientY 則以目前可見視埠的左上角為原點。捲動不會改變這個原點。如果要在目前可見的瀏覽器區域內定位或比較物件,例如自訂游標標記或視埠疊層,請使用這組值。
這兩組座標屬於不同的座標空間,因此計算時應一致使用同一組。混用頁面座標和視埠座標,可能會讓結果偏移捲動距離。若要讓元素跟隨指標,還需要額外的滑鼠事件和元素定位邏輯;單純讀取座標並不會移動元素。
捲動時比較 pageX 和 clientX
捲動前,文件原點和視埠原點重合,因此水平座標 pageX 和 clientX 相同,垂直座標 pageY 和 clientY 也相同。移動指標並查看主控台中的兩組座標。第一張提供的圖片是捲動前的主控台畫面。
向下捲動後,水平座標通常仍會一致;垂直座標 pageY 則包含捲動距離,而 clientY 仍以視埠頂端為基準。兩個垂直座標的差值就是目前的捲動偏移量。第二張提供的圖片是捲動後的主控台畫面。
若要取得目前可見區域內的位置,請使用 clientX 和 clientY;若要取得相對於文件的位置(包括已捲動的內容),則使用 pageX 和 pageY。如需了解更多瀏覽器滑鼠事件,請參閱 MDN 滑鼠事件參考資料。