ECharts 是成熟开源图表库,支持 Canvas 渲染、2D/3D、响应式与交互;推荐模块化引入,初始化需四步:准备容器、init 实例、配置 option、setOption 渲染;支持动态更新、事件监听与 resize 响应。

JavaScript 实现数据可视化,核心是把结构化数据(如数组、对象)转换成图形元素(柱状图、折线图、地图等),而 ECharts 是目前最成熟、中文文档最完善、生态最丰富的开源图表库之一。它基于 Canvas 渲染,性能好、配置灵活、支持 2D/3D、响应式和交互式操作。
引入 ECharts 的三种常用方式
推荐使用模块化引入,避免全局污染,便于按需打包:
-
CDN 引入(适合快速原型或简单页面):在 HTML 的 中加入:
-
NPM 安装(推荐用于 Vue/React 项目):
npm install echarts,然后在 JS 文件中 import:
import * as echarts from 'echarts'; -
按需引入(减小包体积):例如只用柱状图和提示框:
import { init, registerChart } from 'echarts';
import { BarChart } from 'echarts/charts';
import { TooltipComponent } from 'echarts/components';
echarts.use([BarChart, TooltipComponent]);
初始化一个基础柱状图
关键四步:准备 DOM 容器 → 初始化实例 → 配置 option → 渲染图表。
- HTML 中预留一个带 id 的 div:
- JS 中调用 echarts.init() 获取实例(注意容器必须已挂载且有宽高):
const chart = echarts.init(document.getElementById('chart')); - 定义 option 对象(描述图表类型、数据、样式等):
const option = {
title: { text: '月度销售额' },
tooltip: {},
xAxis: { data: ['1月', '2月', '3月', '4月'] },
yAxis: {},
series: [{
name: '销售额',
type: 'bar',
data: [120, 200, 150, 180]
}]
}; - 最后调用 setOption() 渲染:
chart.setOption(option);
动态更新与交互响应
ECharts 天然支持数据驱动更新和用户交互事件,无需手动重绘。
立即学习“Java免费学习笔记(深入)”;
- 更新数据:直接修改 series.data 后再次 setOption,或使用 setOption({ series: [...] }, true)(第二个参数 true 表示不合并,全量替换)
-
监听点击事件:比如点击某根柱子查看详情:
chart.on('click', (params) => {
console.log('点击了', params.name, ',值为', params.value);
}); -
响应窗口变化:防止图表变形,加一句:
window.addEventListener('resize', () => chart.resize());
常见问题与优化建议
实际开发中容易踩坑的地方:










