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 仍以視埠頂端為基準。兩個垂直座標的差值就是目前的捲動偏移量。第二張提供的圖片是捲動後的主控台畫面。

瀏覽器開發人員主控台顯示捲動後不同的 pageY 與 clientY 數值

若要取得目前可見區域內的位置,請使用 clientX 和 clientY;若要取得相對於文件的位置(包括已捲動的內容),則使用 pageX 和 pageY。如需了解更多瀏覽器滑鼠事件,請參閱 MDN 滑鼠事件參考資料。