【亲测免费】 ECharts-GL 深度指南

2026-01-16 10:02:12作者：柯茵沙

项目介绍

ECharts-GL 是 Apache ECharts 的扩展包，专门用于提供地球可视化及三维图表功能。这个库基于 WebGL 技术，支持在网页中展示复杂的三维数据，包括但不限于散点图、线图、地形图等。ECharts-GL 能够帮助开发者轻松创建具有交互性的三维数据可视化应用。

项目快速启动

安装

使用 npm 来安装 ECharts 和 ECharts-GL：

npm install echarts echarts-gl

或者通过 CDN 引入：

<script src="https://cdn.jsdelivr.net/npm/echarts/dist/echarts.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/echarts-gl/dist/echarts-gl.min.js"></script>

基本使用

在你的 JavaScript 文件中导入 ECharts 和 ECharts-GL 组件：

import * as echarts from 'echarts';
import 'echarts-gl';

// 或者按需引入组件
import * as echarts from 'echarts/core';
import { Scatter3DChart } from 'echarts-gl/charts';
import { Grid3DComponent } from 'echarts-gl/components';
echarts.use([Scatter3DChart, Grid3DComponent]);

然后初始化图表并设置配置项：

const chartDom = document.getElementById('main');
const chart = echarts.init(chartDom);

chart.setOption({
  grid3D: {},
  xAxis3D: {},
  yAxis3D: {},
  zAxis3D: {},
  series: [{
    type: 'scatter3D',
    symbolSize: 50,
    data: [
      [-1, -1],
      [0, 0],
      [1, 1]
    ],
    itemStyle: {
      opacity: 1
    }
  }]
});

HTML 示例

<!DOCTYPE html>
<html lang="zh">
<head>
  <meta charset="UTF-8">
  <title>ECharts-GL 示例</title>
  <!-- 引入 ECharts 和 ECharts-GL -->
  <script src="https://cdn.jsdelivr.net/npm/echarts/dist/echarts.min.js"></script>
  <script src="https://cdn.jsdelivr.net/npm/echarts-gl/dist/echarts-gl.min.js"></script>
</head>
<body>
  <div id="main" style="width: 800px;height: 600px;"></div>

  <script>
    // 初始化图表和设置配置项
    const chartDom = document.getElementById('main');
    const chart = echarts.init(chartDom);
    chart.setOption({
      /* ... */
    });
  </script>
</body>
</html>