萬盛學電腦網

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

JavaScript 與 jQuery 獲取滑鼠指標座標:clientX/Y、pageX/Y、offsetX/Y、layerX/Y 跨瀏覽器完整對照

前言

獲取滑鼠座標是拖拽、繪圖、提示框定位等互動的基礎。不同瀏覽器、不同事件模型提供的座標屬性眾多,本文系統整理原生 JS 與 jQuery 獲取座標的最佳實踐。

座標體系速查

屬性參考點含義支援
clientX / clientY視口 (viewport)相對瀏覽器可視區域左上角,不含滾動所有瀏覽器
pageX / pageY文檔 (document)相對文檔左上角,含滾動距離IE9+、標準
screenX / screenY螢幕相對物理螢幕左上角所有瀏覽器
offsetX / offsetY目標元素 (target)相對觸發事件元素內邊距邊緣 (IE/Chrome)IE/Chrome/Edge
layerX / layerY目標元素 (currentTarget)相對當前監聽元素內邊距邊緣 (Firefox/舊版)Firefox/Chrome

原生 JS 通用獲取相對目標元素座標

function getOffset(e) {
    e = e || window.event;
    var target = e.target || e.srcElement;
    // 優先 offsetX/offsetY (IE/Chrome), 其次 layerX/layerY (Firefox)
    var x = e.offsetX !== undefined ? e.offsetX : e.layerX;
    var y = e.offsetY !== undefined ? e.offsetY : e.layerY;
    return { x: x, y: y, target: target };
}

// 使用
document.getElementById('box').addEventListener('mousemove', function (e) {
    var pos = getOffset(e);
    console.log('相對 box 座標:', pos.x, pos.y);
});

jQuery 統一封裝 (內部已處理兼容)

$('#box').on('mousemove', function (e) {
    // jQuery 事件物件統一提供 pageX, pageY, offsetX, offsetY
    // offsetX/offsetY 相對當前元素 (currentTarget)
    console.log('page:', e.pageX, e.pageY);
    console.log('offset:', e.offsetX, e.offsetY);
});

jQuery 內部根據 e.originalEvent 修正 offsetX/Y,開發者可直接使用。

獲取相對文檔座標 (通用)

// 原生
function getPageXY(e) {
    e = e || window.event;
    return {
        x: e.pageX !== undefined ? e.pageX : e.clientX + (document.documentElement.scrollLeft || document.body.scrollLeft),
        y: e.pageY !== undefined ? e.pageY : e.clientY + (document.documentElement.scrollTop || document.body.scrollTop)
    };
}

// jQuery
$('#box').on('click', function (e) {
    console.log('文檔座標:', e.pageX, e.pageY); // jQuery 保證 pageX/Y 存在
});

實戰範例:滑鼠跟隨提示框

<style>
#tooltip { position: absolute; background: #333; color: #fff; padding: 6px 10px; border-radius: 4px; font-size: 12px; pointer-events: none; z-index: 9999; display: none; }
</style>
<div id="tooltip"></div>

<script>
document.addEventListener('mousemove', function (e) {
    var tip = document.getElementById('tooltip');
    tip.style.left = (e.pageX + 15) + 'px';
    tip.style.top = (e.pageY + 15) + 'px';
    tip.textContent = 'X: ' + e.pageX + ', Y: ' + e.pageY;
    tip.style.display = 'block';
});
document.addEventListener('mouseout', function (e) {
    if (!e.relatedTarget || e.relatedTarget === document.body) {
        document.getElementById('tooltip').style.display = 'none';
    }
});
</script>

總結

  • 需相對視口:用 clientX/Y。
  • 需相對文檔:用 pageX/Y (jQuery 保證有) 或 clientX/Y + scrollX/Y。
  • 需相對觸發元素:原生用 offsetX/Y || layerX/Y,jQuery 直接用 offsetX/Y。
  • 現代專案優先使用 jQuery 或封裝通用工具函式,避免手寫兼容邏輯。
copyright © 萬盛學電腦網 all rights reserved