萬盛學電腦網

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

JavaScript 取得滑鼠座標完整指南:跨瀏覽器相容實作

取得滑鼠座標看似簡單,但歷史上 IE 與標準瀏覽器(Firefox、Chrome、Safari)事件物件屬性差異大。本文提供完整跨瀏覽器解決方案,並解析座標系統差異與現代最佳實務。

座標系統基礎知識

屬性參考點說明
clientX/Y視口左上角不含捲軸位移,所有瀏覽器支援
pageX/Y文件左上角含捲軸位移,標準瀏覽器支援,IE9+
screenX/Y螢幕左上角實體螢幕座標,少用
offsetX/Y目標元素左上角非標準,但廣泛支援

經典跨瀏覽器相容函式

function getMousePosition(event) {
    event = event || window.event; // IE 相容
    
    var x, y;
    
    // 標準瀏覽器:pageX/Y 直接可用
    if (event.pageX !== undefined && event.pageY !== undefined) {
        x = event.pageX;
        y = event.pageY;
    }
    // IE 8-:需自行計算捲軸位移
    else {
        var doc = document.documentElement;
        var body = document.body;
        
        x = event.clientX + 
            (doc && doc.scrollLeft || body && body.scrollLeft || 0) - 
            (doc && doc.clientLeft || body && body.clientLeft || 0);
            
        y = event.clientY + 
            (doc && doc.scrollTop || body && body.scrollTop || 0) - 
            (doc && doc.clientTop || body && body.clientTop || 0);
    }
    
    return { x: x, y: y };
}

// 使用範例
document.addEventListener('mousemove', function(e) {
    var pos = getMousePosition(e);
    document.getElementById('x').textContent = pos.x;
    document.getElementById('y').textContent = pos.y;
});

完整可執行範例

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>滑鼠座標即時顯示</title>
<style>
    body { font-family: sans-serif; padding: 20px; }
    .coord { 
        display: inline-block; 
        width: 80px; 
        background: #f0f0f0; 
        padding: 5px 10px; 
        border-radius: 4px; 
        font-family: monospace;
    }
    .label { color: #666; margin-right: 10px; }
</style>
</head>
<body>
<h3>滑鼠座標追蹤</h3>
<p><span class="label">文件座標 (pageX/Y):</span> 
    X: <span id="pageX" class="coord">0</span> 
    Y: <span id="pageY" class="coord">0</span>
</p>
<p><span class="label">視口座標 (clientX/Y):</span> 
    X: <span id="clientX" class="coord">0</span> 
    Y: <span id="clientY" class="coord">0</span>
</p>
<p><span class="label"gt;螢幕座標 (screenX/Y):</span> 
    X: <span id="screenX" class="coord">0</span> 
    Y: <span id="screenY" class="coord">0</span>
</p>

<script>
document.addEventListener('mousemove', function(e) {
    document.getElementById('pageX').textContent = e.pageX;
    document.getElementById('pageY').textContent = e.pageY;
    document.getElementById('clientX').textContent = e.clientX;
    document.getElementById('clientY').textContent = e.clientY;
    document.getElementById('screenX').textContent = e.screenX;
    document.getElementById('screenY').textContent = e.screenY;
});
</script>
</body>
</html>

現代最佳實務:直接使用 pageX/Y

IE11+、Edge、Chrome、Firefox、Safari 全支援 pageX/Y。若無需支援 IE10 以下,程式碼大幅簡化:

document.addEventListener('mousemove', function(e) {
    console.log('文件座標:', e.pageX, e.pageY);
    console.log('視口座標:', e.clientX, e.clientY);
});

進階應用:元素相對座標

取得滑鼠相對特定元素的位置(如 Canvas 繪圖、拖曳定位):

function getRelativePosition(element, event) {
    var rect = element.getBoundingClientRect();
    return {
        x: event.clientX - rect.left,
        y: event.clientY - rect.top
    };
}

// 使用
canvas.addEventListener('mousemove', function(e) {
    var pos = getRelativePosition(canvas, e);
    drawAt(pos.x, pos.y);
});

觸控裝置支援

function getTouchPosition(event) {
    var touch = event.touches[0] || event.changedTouches[0];
    return {
        x: touch.pageX,
        y: touch.pageY,
        clientX: touch.clientX,
        clientY: touch.clientY
    };
}

element.addEventListener('touchmove', function(e) {
    var pos = getTouchPosition(e);
    // 處理觸控移動
}, { passive: true });

效能優化建議

  1. 節流:mousemove 觸發極頻繁,使用 requestAnimationFrame 或 setTimeout 節流
  2. 被動事件監聽器:{ passive: true } 提升捲動效能
  3. 避免佈局抖動:讀取座標後再寫入 DOM,不要交替讀寫
// 節流範例
var ticking = false;
document.addEventListener('mousemove', function(e) {
    if (!ticking) {
        requestAnimationFrame(function() {
            updatePosition(e.pageX, e.pageY);
            ticking = false;
        });
        ticking = true;
    }
});

總結

理解 client/page/screen 三種座標系統差異,掌握歷史 IE 相容寫法,現代開發直接使用標準 pageX/Y。配合 getBoundingClientRect() 可輕鬆轉換為元素相對座標,滿足拖曳、繪圖、遊戲等多樣化需求。

copyright © 萬盛學電腦網 all rights reserved