萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 即時獲取滑鼠座標:相對視窗、文件、螢幕完整實作

JS 滑鼠座標獲取全解析:clientX/Y、pageX/Y、screenX/Y、捲動修正與跨瀏覽器相容寫法

在拖曳互動、遊戲開發、滑鼠追蹤特效、座標標註等場景,精準獲取滑鼠座標是基礎能力。本文詳解各種座標體系、跨瀏覽器相容計算,並提供可直接執行的即時顯示 Demo 程式碼。

一、座標體系速查表

屬性參考基準含捲動適用場景
event.clientX / clientY視窗可視區左上角否定位浮層、Tooltip、相對視窗定位
event.pageX / pageY文件左上角是拖曳、繪圖、元素絕對定位
event.screenX / screenY螢幕左上角否多視窗協作、全螢幕遊戲
event.offsetX / offsetY目標元素邊框內側左上角否Canvas 繪圖、元素內部相對定位
event.layerX / layerY當前元素左上角(非標準)否舊版 Firefox/Gecko 專用

二、跨瀏覽器相容:獲取文件座標 (pageX/Y) 標準寫法

現代瀏覽器(IE9+、所有現代瀏覽器)原生支援 event.pageX/Y。若需支援 IE8 及以下,需手動計算:

/**
 * 統一獲取滑鼠相對文件座標 (pageX, pageY)
 * @param {Event} e - 事件對象
 * @returns {{x: number, y: number}}
 */
function getMousePos(e) {
    e = e || window.event; // IE 相容
    var x = e.pageX;
    var y = e.pageY;

    // IE8- 不支援 pageX/Y,需手動計算
    if (x === undefined || y === undefined) {
        var docEl = document.documentElement;
        var body = document.body;
        x = e.clientX + (docEl.scrollLeft || body.scrollLeft) - (docEl.clientLeft || 0);
        y = e.clientY + (docEl.scrollTop || body.scrollTop) - (docEl.clientTop || 0);
    }
    return { x: x, y: y };
}

// 使用範例
document.addEventListener('mousemove', function (e) {
    var pos = getMousePos(e);
    console.log('滑鼠文件座標:', pos.x, pos.y);
    // 即時更新 UI 元素位置 ...
});

三、完整可執行 Demo:即時顯示滑鼠多種座標

<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>滑鼠座標即時顯示</title>
<style>
  body { font-family: sans-serif; padding: 20px; }
  .coord-box { display: inline-block; width: 220px; padding: 10px; margin: 5px; background: #f0f0f0; border: 1px solid #ccc; border-radius: 4px; }
  .coord-label { font-weight: bold; color: #333; }
  .coord-value { font-family: monospace; color: #0066cc; }
  #track-area { width: 100%; height: 300px; background: #e8f4fd; border: 2px dashed #3a7bd5; margin-top: 20px; position: relative; }
  #cursor-display { position: absolute; top: 10px; left: 10px; background: rgba(0,0,0,0.7); color: #fff; padding: 5px 10px; border-radius: 3px; font-size: 12px; pointer-events: none; }
</style></head><body>

<h2>即時滑鼠座標(在下方藍色區域移動滑鼠)</h2>

<div class="coord-box">
  <div class="coord-label">clientX / clientY (視窗)</div>
  <div class="coord-value" id="d-client">0, 0</div>
</div>
<div class="coord-box">
  <div class="coord-label">pageX / pageY (文件)</div>
  <div class="coord-value" id="d-page">0, 0</div>
</div>
<div class="coord-box">
  <div class="coord-label">screenX / screenY (螢幕)</div>
  <div class="coord-value" id="d-screen">0, 0</div>
</div>
<div class="coord-box">
  <div class="coord-label">offsetX / offsetY (目標元素)</div>
  <div class="coord-value" id="d-offset">0, 0</div>
</div>

<div id="track-area">
  <div id="cursor-display">滑鼠座標</div>
</div>

<script>
var trackArea = document.getElementById('track-area');
var display = document.getElementById('cursor-display');

trackArea.addEventListener('mousemove', function (e) {
    // 1. 視窗座標
    document.getElementById('d-client').textContent = e.clientX + ', ' + e.clientY;

    // 2. 文件座標 (pageX/Y 現代瀏覽器原生支援)
    document.getElementById('d-page').textContent = e.pageX + ', ' + e.pageY;

    // 3. 螢幕座標
    document.getElementById('d-screen').textContent = e.screenX + ', ' + e.screenY;

    // 4. 目標元素內部座標
    document.getElementById('d-offset').textContent = e.offsetX + ', ' + e.offsetY;

    // 5. 更新跟隨顯示框
    display.style.left = e.offsetX + 15 + 'px';
    display.style.top = e.offsetY + 15 + 'px';
    display.textContent = 'client: ' + e.clientX + ',' + e.clientY
        + ' | page: ' + e.pageX + ',' + e.pageY;
});
</script>
</body></html>

四、實戰應用場景

1. 拖曳元素(以文件座標為基準)

var isDragging = false, startX, startY, elX, elY;

$('#draggable').on('mousedown', function (e) {
    isDragging = true;
    startX = e.pageX; startY = e.pageY;
    elX = parseInt($(this).css('left'), 10) || 0;
    elY = parseInt($(this).css('top'), 10) || 0;
    $(document).on('mousemove.drag', onDrag).on('mouseup.drag', onDragEnd);
});

function onDrag(e) {
    if (!isDragging) return;
    $('#draggable').css({
        left: elX + (e.pageX - startX),
        top: elY + (e.pageY - startY)
    });
}
function onDragEnd() {
    isDragging = false;
    $(document).off('.drag');
}

2. Canvas 繪圖(使用 offsetX/Y)

canvas.addEventListener('mousemove', function (e) {
    var ctx = canvas.getContext('2d');
    var x = e.offsetX, y = e.offsetY;
    // 繪製邏輯 ...
});

3. Tooltip/浮層定位(視窗座標 + 捲動修正)

function showTooltipAtMouse(e, text) {
    var x = e.clientX + 10;
    var y = e.clientY + 10;
    $tooltip.css({ left: x, top: y }).text(text).show();
}

五、觸控裝置支援

function getTouchPos(e) {
    var touch = e.touches[0] || e.changedTouches[0];
    return {
        clientX: touch.clientX,
        clientY: touch.clientY,
        pageX: touch.pageX,
        pageY: touch.pageY,
        screenX: touch.screenX,
        screenY: touch.screenY
    };
}

element.addEventListener('touchmove', function (e) {
    var pos = getTouchPos(e);
    // 同樣邏輯處理 ...
}, { passive: true });

六、效能優化提醒

  • mousemove 事件極高頻,處理函式務必極簡(避免重排、複雜計算)。
  • 需節流:requestAnimationFrame 或 setTimeout 降低 UI 更新頻率。
  • 大量座標計算考慮 Web Worker 或 pointermove (Pointer Events)。

掌握座標體系與相容寫法,您就能自信處理所有滑鼠/觸控互動開發需求。

copyright © 萬盛學電腦網 all rights reserved