Начало работы
Установка и первый график
ECharts инициализируется на DOM-элементе с явно заданными шириной и высотой. setOption настраивает весь график. Apache ECharts (ранее Baidu ECharts) — одна из самых мощных JS-библиотек для графиков.
<!-- 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() при удалении графика, чтобы освободить память.
// 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 — современный способ следить за размером контейнера (лучше, чем resize окна, для изменений из-за вёрстки). Всегда вызывайте dispose() при размонтировании, чтобы избежать утечек в SPA.
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 заменяет весь option (полезно, когда меняется число серий). replaceMerge адресно заменяет конкретные типы компонентов (series, xAxis). lazyUpdate объединяет несколько вызовов setOption в один рендер.
const chart = echarts.init(document.getElementById('chart'));
// merge (default): deep-merges with existing option
chart.setOption({ xAxis: { data: ['A', 'B'] } });
// notMerge: replace entire option (old config discarded)
chart.setOption({ xAxis: { data: ['X', 'Y'] } }, { notMerge: true });
// replaceMerge: replace specific component types only
chart.setOption(
{ series: [{ type: 'bar', data: [5, 6] }] },
{ replaceMerge: ['series'] }
);
// lazyUpdate: batch updates, apply on next frame
chart.setOption({ series: [{ data: [1, 2] }] }, { lazyUpdate: true });Жизненный цикл: getInstanceByDom и dispose
Вызов init на DOM, где уже есть график, бросает исключение. Проверяйте через getInstanceByDom. dispose() освобождает память и удаляет график, но DOM-элемент остаётся. Атрибут _echarts_instance_ помечает контейнеры графиков — по нему можно найти и убрать забытые экземпляры. Всегда вызывайте dispose в хуках размонтирования фреймворка.
function mountChart(dom) {
// avoid double-init on the same DOM node
const existing = echarts.getInstanceByDom(dom);
if (existing) return existing;
const chart = echarts.init(dom);
chart.setOption({ /* ... */ });
return chart;
}
// in a framework cleanup (React useEffect / Vue onUnmounted):
function unmount(dom) {
const chart = echarts.getInstanceByDom(dom);
if (chart) chart.dispose(); // free memory + remove DOM
}
// dispose all charts on a page
echarts.disposeAll?.(); // not built-in; iterate manually
Array.from(document.querySelectorAll('[_echarts_instance_]'))
.forEach(dom => echarts.dispose(dom));Столбчатые диаграммы
Базовый столбчатый график
Столбчатому графику нужен категориальный xAxis и числовой yAxis. Каждое значение series.data соответствует одной категории. itemStyle управляет внешним видом столбцов. Для вертикальных столбцов категориальная ось — x; для горизонтальных поменяйте типы осей x и y местами.