01
入门
安装与第一个图表
ECharts 在带有明确宽高的 DOM 元素上初始化。setOption 配置整个图表。Apache ECharts(原百度 ECharts)是最强大的 JavaScript 图表库之一。
echarts
<!-- include ECharts -->
<script src="https://cdn.jsdelivr.net/npm/echarts@5/dist/echarts.min.js"></script>
<div id="chart" style="width: 600px; height: 400px;"></div>
<script>
const chart = echarts.init(document.getElementById('chart'));
chart.setOption({
title: { text: 'Sales' },
xAxis: { data: ['Q1', 'Q2', 'Q3', 'Q4'] },
yAxis: {},
series: [{
type: 'bar',
data: [100, 200, 150, 300]
}]
});
</script>主题与渲染器初始化
init 接收 (dom, theme, opts) 参数。'svg' 渲染器在任何缩放级别都更清晰,且对简单图表生成更小的 DOM,而 'canvas' 对大数据集更快。devicePixelRatio 控制 retina 屏幕的清晰度。移除图表时务必调用 dispose() 释放内存。
echarts
// register a theme (defined elsewhere or imported)
echarts.registerTheme('myTheme', {
color: ['#5470c6', '#91cc75'],
backgroundColor: '#f5f5f5'
});
// renderer: 'canvas' (default, faster) or 'svg' (sharper, lighter)
const chart = echarts.init(document.getElementById('chart'), 'myTheme', {
renderer: 'svg',
devicePixelRatio: 2,
width: 800,
height: 600,
locale: 'EN'
});
// detached from DOM later
chart.dispose();响应式缩放
ECharts 不会在容器变化时自动缩放——必须调用 chart.resize()。ResizeObserver 是监听容器尺寸的现代方式(比 window resize 更适合布局驱动的变化)。在 SPA 中 务必在卸载时 dispose() 以防止内存泄漏。
echarts
const chart = echarts.init(document.getElementById('chart'));
chart.setOption({ /* ... */ });
// resize when window changes
window.addEventListener('resize', () => chart.resize());
// or observe the container
const ro = new ResizeObserver(() => chart.resize());
ro.observe(document.getElementById('chart'));
// resize with explicit size
chart.resize({ width: 500, height: 300, silent: false });
// cleanup
window.addEventListener('unload', () => chart.dispose());setOption 合并模式
默认情况下 setOption 深度合并新选项到已有选项中,因此可以更新单个部分。notMerge: true 替换整个选项(在 series 数量变化时有用)。replaceMerge 针对特定组件类型(series、xAxis)进行部分替换。lazyUpdate 将多次 setOption 调用批处理为一次渲染。
echarts