DIV CSS 佈局教程網

即時取得並顯示滑鼠座標:pageX 與 clientX 的差別
編輯:關於JavaScript     

要在頁面上顯示游標座標,看起來只要讀 event.clientX 就好。但一旦頁面可以捲動,就會發現數字對不上——這裡有兩組座標系統需要分清楚。

兩組座標:client 與 page

  • clientX / clientY:相對於可視區域(viewport)左上角。游標不動時捲動頁面,這個值不變。
  • pageX / pageY:相對於整個文件左上角。等於 client 加上捲動量。

做「跟著游標跑的浮動提示」要用 client,做「在文件上標記點擊位置」要用 page。搞錯就會出現捲動後位置飄掉的經典 bug。

相容寫法

老瀏覽器(IE8 以前)不支援 pageX,必須手動加上捲動偏移:

function getPointerInDocument(e) {
  e = e || window.event;
  return {
    x: e.pageX || (e.clientX + (document.documentElement.scrollLeft || document.body.scrollLeft)),
    y: e.pageY || (e.clientY + (document.documentElement.scrollTop  || document.body.scrollTop ))
  };
}

documentElement.scrollLeft || body.scrollLeft 這種寫法,是為了應對不同瀏覽器(以及 quirks mode 與 standards mode)把捲動量放在不同元素上的歷史差異。現在一律可以直接寫 window.scrollX / window.scrollY。

完整範例

<div id="coords" style="width:500px; height:200px; background:#F2F1D7;
     border:2px solid #0066cc;">請在此移動滑鼠</div>
<br />
<div id="coord" style="width:500px; border:2px solid #336699;"> </div>

<script>
const area = document.getElementById('coords');
const output = document.getElementById('coord');

area.addEventListener('mousemove', e => {
  const x = e.pageX || (e.clientX + window.scrollX);
  const y = e.pageY || (e.clientY + window.scrollY);
  output.textContent = `文件座標:X = ${x}, Y = ${y}`;
});
</script>

監聽掛在 #coords 而非 document 上,就只會在該區域內更新,這通常才是使用者期待的行為。

幾個實務提醒

不要直接 document.write。它會在文件載入後清空整個頁面。更新顯示內容請用 textContent 或 innerHTML。

mousemove 觸發非常頻繁。如果回呼裡有複雜運算或 DOM 大量操作,容易卡頓。若只需要最終位置,改用 mousemove 搭配 requestAnimationFrame 節流,或乾脆監聽 click。

要取得游標所在的元素,用 e.target。座標與目標元素是兩件不同的事,別把 offsetX(相對於目標元素)和 clientX(相對於視窗)混用——這是最常見的混淆點。

觸控裝置沒有 mousemove。行動裝置上請監聽 touchmove,座標要從 e.touches[0].clientX 取得;或直接用 pointer events 統一處理。

把 client 與 page 的定義記清楚,加上 offsetX/Y(相對目標元素)這一組,你就掌握了前端所有的座標系統。這三組分別對應「視窗、文件、元素」三個參照點,選錯參照點是位置計算出錯的頭號原因。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved