echarts 3d地图解决鼠标移动到地图中非区域块的空白区域时，触发特定事件

关注

原创最新推荐文章于 2026-08-31 09:51:52 发布 256 阅读 AI 写同款· GEO 优化 ›

ECharts GL 3D地图开发实战：从环境搭建到性能优化数据可视化是前端开发与数据分析领域的关键技术，旨在将复杂数据转化为直观的图形，以揭示其内在模式与趋势。其核心原理在于利用视觉通道（如位置、大小、颜色、形状）对数据进行编码，从而提升信息的认知效率。在众多应用场景中，地理空间数据的可视化尤为常见，而传统的二维地图在表达多维数据（如高度、密度、趋势）时存在局限。为此，引入WebGL等3D渲染技术，构建具有深度维度的3D地图，成为展示复杂地理空间关联与多指标数据的强大解决方案。ECharts GL作为ECharts的扩展库，专门用于实现基于WebGL的高性能3D图阅读详情

问题描述：当鼠标移入到指定区块时右下角显示该区域详细信息，滑出或划入到空白区域时隐藏右下角的弹出框。使用mouseout只能实现当从区块A移动到区划B时才会触发该方法，无法实现。
在这里插入图片描述

解决方案：使用chartInstance.getZr().on(‘mousemove’, (e : any) => {})实现是否处于空白区域

const chart3d = ref<HTMLElement | null>(null);
let chartInstance: echarts.ECharts | null = null;
const iniEcharts = () => {
		if (!chart3d.value) return;
    // 先销毁示例
    if (chartInstance) {
        chartInstance.dispose();
        chartInstance = null;
    }
    chartInstance = echarts.init(chart3d.value);
    // 注册地图
    echarts.registerMap('Shaanxi', shaanxiGeoJSON as any);
		
		const option = {}
		chartInstance.setOption(option);

		chartInstance.on('mouseover', function (params: any) {
		        // 划入到区块上时线上右下角弹出框
		        showRightSide(params.data);
		});
		let debounceTimer: any = null;
    let lastEvent: any = null; // 保存最后的事件

    chartInstance.getZr().on('mousemove', (e : any) => {
        lastEvent = e; // 保存最新的事件
        if (debounceTimer) {
            clearTimeout(debounceTimer);
        }
        debounceTimer = setTimeout(() => {
            if (lastEvent.target == undefined) {
                console.log('空白区域，隐藏右下角弹框');
                hideRightSide();
            } else {
                console.log('非空白区域');
            }
        }, 100);
    });

    chartInstance.on('globalout', function (params: any) {
        const toElement = params.event.event.toElement;
        if(toElement){
        		// 鼠标移出该地图区域，不包括右下角弹框元素
            const hasMapRightSideClass = toElement.classList && toElement.classList.contains('map-right-side');
            if(!hasMapRightSideClass){
                hideRightSide();
            }
        }
    });
}
...