萬盛學電腦網

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

JavaScript獲取鼠標座標:跨瀏覽器兼容性處理與現代MouseEvent屬性

獲取鼠標在頁面/視口/螢幕上的座標是拖拽、提示框定位、畫板等交互基礎。本文系統梳理clientX/Y、pageX/Y、screenX/Y、offsetX/Y、layerX/Y五組座標體系,修正原文scrollLeft/Top兼容性邏輯,提供現代標準化封裝。

五大座標體系速查

屬性參考系含義典型用途
clientX/Y視口 (可視區)鼠標相對瀏覽器窗口左上角固定定位元素定位、懸浮框
pageX/Y文檔 (整頁)鼠標相對文檔左上角 (含滾動)絕對定位元素、拖拽、標註
screenX/Y螢幕 (物理屏)鼠標相對顯示器左上角多螢幕、系統級交互
offsetX/Y目標元素邊框內鼠標相對觸發事件元素padding box左上角Canvas繪圖、內部相對定位
layerX/Y當前佈局層非標準,Firefox/Chrome行為不同避免使用

原文代碼問題修正

// 原文:document.documentElement.scrollLeft 不兼容 Chrome/舊版 Safari
var scrollLeft = document.documentElement.scrollLeft || document.body.scrollLeft;
var scrollTop = document.documentElement.scrollTop || document.body.scrollTop;

// 現代標準:window.scrollX / scrollY (別名 pageXOffset/pageYOffset)
var scrollLeft = window.scrollX; // 或 window.pageXOffset
var scrollTop = window.scrollY;  // 或 window.pageYOffset

// pageX/Y 現代瀏覽器原生支援 (IE9+)
var pageX = event.pageX;
var pageY = event.pageY;

// 兼容性封裝:獲取文檔座標
function getPageCoords(event) {
    event = event || window.event;
    if (event.pageX != null) { // 現代瀏覽器
        return { x: event.pageX, y: event.pageY };
    }
    // IE8- 降級計算
    var doc = document.documentElement;
    var body = document.body;
    return {
        x: event.clientX + (doc.scrollLeft || body.scrollLeft) - (doc.clientLeft || 0),
        y: event.clientY + (doc.scrollTop || body.scrollTop) - (doc.clientTop || 0)
    };
}

完整實用工具類

const MouseUtil = {
    // 獲取相對文檔座標 (推薦)
    getPageXY(event) {
        event = event || window.event;
        return { x: event.pageX, y: event.pageY };
    },
    
    // 獲取相對視口座標
    getClientXY(event) {
        event = event || window.event;
        return { x: event.clientX, y: event.clientY };
    },
    
    // 獲取相對元素座標 (需傳入目標元素)
    getOffsetXY(event, targetEl) {
        const rect = targetEl.getBoundingClientRect();
        const client = this.getClientXY(event);
        return {
            x: client.x - rect.left,
            y: client.y - rect.top
        };
    },
    
    // 綁定移動/點擊統一監聽
    bindTracking(handler) {
        const moveHandler = (e) => handler(this.getPageXY(e), 'move');
        const clickHandler = (e) => handler(this.getPageXY(e), 'click');
        document.addEventListener('mousemove', moveHandler, { passive: true });
        document.addEventListener('click', clickHandler);
        return () => {
            document.removeEventListener('mousemove', moveHandler);
            document.removeEventListener('click', clickHandler);
        };
    }
};

// 使用
const unbind = MouseUtil.bindTracking((coords, type) => {
    console.log(`${type}:`, coords.x, coords.y);
});

實戰場景:Tooltip 智能定位

function showTooltip(event, content) {
    const { x, y } = MouseUtil.getPageXY(event);
    const tooltip = document.getElementById('tooltip');
    tooltip.textContent = content;
    tooltip.style.left = (x + 10) + 'px';
    tooltip.style.top = (y + 10) + 'px';
    tooltip.style.display = 'block';
    
    // 防止超出視口右/下邊緣
    requestAnimationFrame(() => {
        const rect = tooltip.getBoundingClientRect();
        const vpW = window.innerWidth, vpH = window.innerHeight;
        if (rect.right > vpW) tooltip.style.left = (x - rect.width - 10) + 'px';
        if (rect.bottom > vpH) tooltip.style.top = (y - rect.height - 10) + 'px';
    });
}

觸控設備兼容

function getTouchCoords(event) {
    const touch = event.touches[0] || event.changedTouches[0];
    return { x: touch.pageX, y: touch.pageY };
}

// 統一綁定
['mousemove', 'touchmove'].forEach(type => 
    document.addEventListener(type, e => handler(getTouchCoords(e)), { passive: true })
);
copyright © 萬盛學電腦網 all rights reserved