Skip to content

ECharts Шпаргалка

Мощная библиотека графиков и визуализации данных от Apache.

01

Начало работы

Установка и первый график

ECharts инициализируется на DOM-элементе с явно заданными шириной и высотой. setOption настраивает весь график. Apache ECharts (ранее Baidu ECharts) — одна из самых мощных JS-библиотек для графиков.

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 — современный способ следить за размером контейнера (лучше, чем resize окна, для изменений из-за вёрстки). Всегда вызывайте dispose() при размонтировании, чтобы избежать утечек в SPA.

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 заменяет весь option (полезно, когда меняется число серий). replaceMerge адресно заменяет конкретные типы компонентов (series, xAxis). lazyUpdate объединяет несколько вызовов setOption в один рендер.

echarts
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 в хуках размонтирования фреймворка.

echarts
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));
02

Столбчатые диаграммы

Базовый столбчатый график

Столбчатому графику нужен категориальный xAxis и числовой yAxis. Каждое значение series.data соответствует одной категории. itemStyle управляет внешним видом столбцов. Для вертикальных столбцов категориальная ось — x; для горизонтальных поменяйте типы осей x и y местами.

echarts
chart.setOption({
  xAxis: {
    type: 'category',
    data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri']
  },
  yAxis: { type: 'value' },
  series: [{
    type: 'bar',
    data: [120, 200, 150, 80, 70],
    itemStyle: { color: '#5470c6' }
  }]
});

Сгруппированные и стековые столбцы

Несколько серий столбцов с одним xAxis по умолчанию группируются. Чтобы сложить их в стек, задайте всем сериям одинаковое имя stack. Стек накапливает значения по категориям. Задайте stack: 'total' всем сериям, которые должны складываться, — серии без имени stack всё равно группируются.

echarts
chart.setOption({
  xAxis: { type: 'category', data: ['Q1', 'Q2', 'Q3', 'Q4'] },
  yAxis: { type: 'value' },
  // GROUPED: multiple series render side by side
  series: [
    { type: 'bar', name: 'A', data: [10, 20, 30, 40] },
    { type: 'bar', name: 'B', data: [15, 25, 35, 45] }
  ]
});

// STACKED: add stack with same name to each series
chart.setOption({
  series: [
    { type: 'bar', name: 'A', stack: 'total', data: [10, 20, 30, 40] },
    { type: 'bar', name: 'B', stack: 'total', data: [15, 25, 35, 45] }
  ]
});

Горизонтальные столбцы

Горизонтальный столбчатый график — это тот же bar, но категориальная ось на yAxis, а числовая на xAxis. Метки с position: 'right' стоят у конца столбца. Горизонтальные столбцы лучше для длинных названий категорий и когда категорий много — не приходится поворачивать подписи.

echarts
chart.setOption({
  // swap: category axis becomes yAxis
  yAxis: {
    type: 'category',
    data: ['Apple', 'Banana', 'Cherry', 'Date']
  },
  xAxis: { type: 'value' },
  series: [{
    type: 'bar',
    data: [120, 200, 150, 80],
    label: {
      show: true,
      position: 'right'  // label at end of bar
    }
  }]
});

Столбцы с фоном и скруглением

showBackground рисует дорожку позади каждого столбца (стиль progress bar). itemStyle.borderRadius скругляет углы — передавайте [topLeft, topRight, bottomRight, bottomLeft] для вертикальных столбцов; для горизонтальных порядок обратный. borderRadius может быть числом (все углы) или массивом.

echarts
chart.setOption({
  xAxis: { type: 'category', data: ['A', 'B', 'C', 'D'] },
  yAxis: { type: 'value' },
  series: [{
    type: 'bar',
    data: [50, 80, 60, 90],
    showBackground: true,
    backgroundStyle: {
      color: 'rgba(180, 180, 180, 0.2)',
      borderRadius: [4, 4, 0, 0]
    },
    itemStyle: {
      borderRadius: [8, 8, 0, 0]  // round top corners
    }
  }]
});

Bar race (динамика)

Bar race анимирует перестановку. Отсортируйте массив данных, затем обновите и категории yAxis, и данные серии. animationDurationUpdate управляет плавностью перехода. yAxis.inverse: true ставит наибольшее значение наверх. Приём популярен в анимированных историях данных.

echarts
const data = [
  { name: 'A', value: 10 },
  { name: 'B', value: 20 }
];

chart.setOption({
  xAxis: { type: 'value', max: 100 },
  yAxis: { type: 'category', inverse: true },
  series: [{
    type: 'bar',
    data: data.map(d => ({ value: d.value, name: d.name })),
    label: { show: true, position: 'right' },
    // sort bars by value on each update
    animationDuration: 500,
    animationDurationUpdate: 500
  }]
});

// update data on interval
setInterval(() => {
  data.forEach(d => d.value += Math.random() * 10);
  data.sort((a, b) => b.value - a.value);
  chart.setOption({
    yAxis: { data: data.map(d => d.name) },
    series: [{ data: data.map(d => d.value) }]
  });
}, 1000);

Ширина и отступы столбцов

barWidth принимает пиксели или процент от полосы категории. barGap — зазор между столбцами внутри группы (важен только при нескольких сериях). barCategoryGap — зазор между группами. Проценты считаются от полосы категории, поэтому остаются пропорциональными при ресайзе.

echarts
chart.setOption({
  xAxis: { type: 'category', data: ['A', 'B', 'C', 'D'] },
  yAxis: { type: 'value' },
  series: [{
    type: 'bar',
    data: [50, 80, 60, 90],
    barWidth: '40%',          // width of each bar
    barGap: '20%',            // gap between bars in same group
    barCategoryGap: '40%',    // gap between category groups
    // fixed pixel width also works:
    // barWidth: 30
  }]
});
03

Линейные графики

Базовый линейный график

Линейный график использует type: 'line'. Точки по умолчанию показываются маркерами; задайте symbol: 'none', чтобы скрыть их. Линия соединяет точки в порядке данных. Для временных рядов используйте type: 'time' на xAxis с парами [timestamp, value].

echarts
chart.setOption({
  xAxis: { type: 'category', data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri'] },
  yAxis: { type: 'value' },
  series: [{
    type: 'line',
    data: [120, 200, 150, 80, 70],
    symbol: 'circle',      // point marker
    symbolSize: 8
  }]
});

Сглаженная линия и область

smooth: true сглаживает линию (интерполяция Catmull-Rom). areaStyle заливает область под линией; градиент (линейные цветовые остановки) даёт эффект затухания. boundaryGap: false на категориальной оси начинает линию от края оси Y, а не с отступом.

echarts
chart.setOption({
  xAxis: { type: 'category', boundaryGap: false, data: ['Mon','Tue','Wed','Thu','Fri'] },
  yAxis: { type: 'value' },
  series: [{
    type: 'line',
    data: [120, 200, 150, 80, 70],
    smooth: true,           // curved line
    areaStyle: {            // fill under line
      color: {
        type: 'linear',
        x: 0, y: 0, x2: 0, y2: 1,
        colorStops: [
          { offset: 0, color: 'rgba(84,112,198,0.5)' },
          { offset: 1, color: 'rgba(84,112,198,0.05)' }
        ]
      }
    }
  }]
});

Несколько серий линий

Несколько серий рисуются отдельными линиями и различаются цветом. Легенда переключает видимость. lineStyle.type принимает 'solid', 'dashed', 'dotted'. У каждой серии может быть свой стиль. Имя в легенде должно совпадать с series.name.

echarts
chart.setOption({
  legend: { data: ['Email', 'Search'] },
  xAxis: { type: 'category', data: ['Mon','Tue','Wed','Thu','Fri'] },
  yAxis: { type: 'value' },
  series: [
    {
      type: 'line',
      name: 'Email',
      data: [120, 132, 101, 134, 90],
      lineStyle: { width: 3, type: 'solid' }
    },
    {
      type: 'line',
      name: 'Search',
      data: [220, 182, 191, 234, 290],
      lineStyle: { width: 2, type: 'dashed' }
    }
  ]
});

Стековая область

Стековые графики области используют type: 'line' с одинаковым именем stack и areaStyle. Каждая серия укладывается поверх предыдущей. emphasis.focus: 'series' подсвечивает всю серию при наведении. Удобно показывать состав во времени (например, трафик по источникам).

echarts
chart.setOption({
  xAxis: { type: 'category', boundaryGap: false, data: ['Mon','Tue','Wed','Thu','Fri'] },
  yAxis: { type: 'value' },
  series: [
    {
      type: 'line',
      name: 'A',
      stack: 'total',
      areaStyle: {},
      data: [120, 132, 101, 134, 90],
      emphasis: { focus: 'series' }
    },
    {
      type: 'line',
      name: 'B',
      stack: 'total',
      areaStyle: {},
      data: [220, 182, 191, 234, 290]
    }
  ]
});

Ступенчатая линия

step превращает линию в лестницу. 'start' делает ступеньку до точки, 'middle' (симметрично) — на точке, 'end' — после. Ступенчатые графики хороши для значений, меняющихся дискретно (уровни запасов, статус сервера), а не плавно.

echarts
chart.setOption({
  xAxis: { type: 'category', data: ['Mon','Tue','Wed','Thu','Fri'] },
  yAxis: { type: 'value' },
  series: [{
    type: 'line',
    data: [120, 200, 150, 80, 70],
    step: 'middle',          // 'start' | 'middle' | 'end'
    symbol: 'none',
    lineStyle: { width: 2 }
  }]
});

Линия с временной осью

С type: 'time' ось сама форматирует даты и обрабатывает неравные интервалы. Точки данных — пары [timestamp, value]. ECharts расставляет точки по фактическому времени, поэтому пропуски в данных видны корректно. Это правильный выбор для временных рядов с разными интервалами.

echarts
chart.setOption({
  xAxis: { type: 'time' },   // auto-parses timestamps
  yAxis: { type: 'value' },
  series: [{
    type: 'line',
    data: [
      [new Date('2024-01-01').getTime(), 100],
      [new Date('2024-01-02').getTime(), 200],
      [new Date('2024-01-05').getTime(), 150],
      [new Date('2024-01-10').getTime(), 300]
    ],
    smooth: true
  }]
});
04

Круговые диаграммы

Базовая круговая диаграмма

Круговым диаграммам не нужны оси — series.data это массив {value, name}. radius задаёт размер круга в процентах от меньшей стороны контейнера. Стили emphasis применяются при наведении. Легенда автоматически берёт подписи из data.name.

echarts
chart.setOption({
  series: [{
    type: 'pie',
    radius: '60%',          // radius of pie
    data: [
      { value: 1048, name: 'Search' },
      { value: 735, name: 'Direct' },
      { value: 580, name: 'Email' },
      { value: 484, name: 'Union' },
      { value: 300, name: 'Video' }
    ],
    emphasis: {
      itemStyle: {
        shadowBlur: 10,
        shadowOffsetX: 0,
        shadowColor: 'rgba(0,0,0,0.5)'
      }
    }
  }]
});

Кольцевая диаграмма

radius в виде [inner, outer] создаёт кольцо. Подпись в центре — частый приём (показать сумму или KPI). avoidLabelOverlap: false оставляет подписи на местах. Внутренний радиус задаёт толщину кольца: [50%, 70%] — тонкое кольцо, [0%, 70%] — полный круг.

echarts
chart.setOption({
  series: [{
    type: 'pie',
    radius: ['40%', '70%'],   // [inner, outer] = ring
    avoidLabelOverlap: false,
    label: {
      show: true,
      position: 'center',     // center label
      formatter: 'Total\n{c}'
    },
    data: [
      { value: 1048, name: 'A' },
      { value: 735, name: 'B' },
      { value: 580, name: 'C' }
    ]
  }]
});

Роза (диаграмма Найтингейл)

roseType делает радиус сектора пропорциональным значению (роза Найтингейл). 'area' использует sqrt(value) для радиуса (пропорционально площади), 'radius' — значение напрямую. У всех секторов одинаковый угол, но разный радиус. Хорошо для сравнения величин, когда по одному углу судить трудно.

echarts
chart.setOption({
  series: [{
    type: 'pie',
    radius: ['10%', '70%'],
    roseType: 'area',         // or 'radius'
    data: [
      { value: 40, name: 'A' },
      { value: 38, name: 'B' },
      { value: 32, name: 'C' },
      { value: 30, name: 'D' },
      { value: 28, name: 'E' }
    ],
    label: { show: true }
  }]
});

Круговая диаграмма с подписями

label.formatter поддерживает шаблонные переменные: {a} (имя серии), {b} (имя данных), {c} (значение), {d} (процент). labelLine управляет соединительной линией. length — отрезок у сектора, length2 — отрезок у подписи. Настраиваемые подписи делают круговые диаграммы гораздо понятнее.

echarts
chart.setOption({
  series: [{
    type: 'pie',
    radius: '60%',
    label: {
      formatter: '{b}: {d}%',   // name: percentage
      color: '#333',
      fontSize: 14
    },
    labelLine: {
      show: true,
      length: 15,              // first segment
      length2: 20,             // second segment
      smooth: true
    },
    data: [
      { value: 1048, name: 'Search' },
      { value: 735, name: 'Direct' }
    ]
  }]
});

Полукруглая диаграмма

Сочетание startAngle и endAngle создаёт частичные круги (половина, четверть, в стиле датчика). center позиционирует диаграмму: ['50%','70%'] сдвигает её вниз, чтобы полукруг 180° стоял у нижнего края. Частичные круги часто используют как индикаторы или для стильных дашбордов.

echarts
chart.setOption({
  series: [{
    type: 'pie',
    radius: ['40%', '70%'],
    center: ['50%', '70%'],    // move down
    startAngle: 180,           // start at left
    endAngle: 360,             // end at right -> semicircle
    data: [
      { value: 60, name: 'A' },
      { value: 30, name: 'B' },
      { value: 10, name: 'C' }
    ]
  }]
});
05

Точечные диаграммы

Базовая точечная диаграмма

Точечные диаграммы используют две числовые оси; каждая точка — [x, y]. symbolSize задаёт размер точки (фиксированный или через функцию). Scatter показывает корреляцию двух переменных. Обе оси имеют type: 'value' (числовые), в отличие от категориальных bar/line.

echarts
chart.setOption({
  xAxis: { type: 'value' },
  yAxis: { type: 'value' },
  series: [{
    type: 'scatter',
    symbolSize: 12,
    data: [
      [10, 20], [15, 25], [20, 30], [25, 35],
      [30, 40], [35, 45], [40, 50], [45, 55]
    ],
    itemStyle: { color: '#5470c6' }
  }]
});

Пузырьковая диаграмма (размер по значению)

Пузырьковая диаграмма — это scatter, где размер точки кодирует третье измерение. Передавайте [x, y, size] для каждой точки и задайте symbolSize как функцию, возвращающую размер. Функция вызывается для каждой точки, поэтому каждый пузырь масштабируется отдельно. Удобно для данных с тремя переменными без 3D.

echarts
chart.setOption({
  xAxis: { type: 'value' },
  yAxis: { type: 'value' },
  series: [{
    type: 'scatter',
    // each point: [x, y, size]
    data: [
      [10, 20, 30],
      [15, 25, 60],
      [20, 30, 12],
      [25, 35, 45]
    ],
    symbolSize: function (data) {
      return data[2];           // use 3rd element as size
    }
  }]
});

Scatter с visualMap (цвет по значению)

visualMap сопоставляет измерение данных с цветом. dimension: 2 окрашивает по третьему элементу (индекс 2) каждой точки. inRange.color задаёт градиент. Так в scatter добавляется четвёртое измерение (цвет). Компонент visualMap показывает легенду с ползунком.

echarts
chart.setOption({
  xAxis: { type: 'value' },
  yAxis: { type: 'value' },
  visualMap: {
    min: 0,
    max: 100,
    dimension: 2,             // map color to 3rd element
    inRange: { color: ['#50a3ba', '#eac736', '#d94e5d'] },
    right: 10,
    top: 'center'
  },
  series: [{
    type: 'scatter',
    data: [[10,20,30], [15,25,60], [20,30,12]],
    symbolSize: 15
  }]
});

Effect scatter (анимация)

effectScatter добавляет пульсирующую анимацию вокруг каждой точки — отлично для выделения ключевых точек (оповещения, топ городов). showEffectOn управляет моментом пульсации. brushType: 'stroke' легче, 'fill' заметнее. Используйте умеренно: слишком много пульсаций отвлекает.

echarts
chart.setOption({
  xAxis: { type: 'value' },
  yAxis: { type: 'value' },
  series: [{
    type: 'effectScatter',    // animated ripple
    symbolSize: function (data) { return data[2]; },
    data: [[10, 20, 30], [15, 25, 60]],
    showEffectOn: 'render',   // 'render' or 'emphasis'
    rippleEffect: {
      brushType: 'stroke',    // 'stroke' or 'fill'
      period: 4,
      scale: 3
    }
  }]
});

Scatter для больших данных

Для тысяч точек включите progressive rendering — ECharts разбивает данные на части и рисует их по кадрам, чтобы избежать зависания. large: true использует один оптимизированный вызов отрисовки. Сочетайте с малым symbolSize и прозрачностью, чтобы бороться с наложением точек. Так 50k+ точек остаются плавными.

echarts
// for thousands of points, use progressive rendering
chart.setOption({
  xAxis: { type: 'value' },
  yAxis: { type: 'value' },
  series: [{
    type: 'scatter',
    data: largeDataArray,    // 50k+ points
    symbolSize: 3,
    progressive: 2000,        // chunk size for progressive render
    progressiveThreshold: 5000,  // enable above this count
    large: true,              // optimize for many points
    largeThreshold: 2000,
    itemStyle: { opacity: 0.6 }
  }]
});
06

Радарные диаграммы

Базовый радар

Радару нужен массив radar.indicator, описывающий каждую ось (имя и max). Данные серии — массив значений, соответствующих индикаторам. Радар хорош для сравнения нескольких характеристик небольшого числа объектов (статистика игроков, сравнение товаров). max задаёт шкалу каждой оси.

echarts
chart.setOption({
  radar: {
    indicator: [
      { name: 'Speed', max: 100 },
      { name: 'Power', max: 100 },
      { name: 'Range', max: 100 },
      { name: 'Comfort', max: 100 },
      { name: 'Price', max: 100 }
    ]
  },
  series: [{
    type: 'radar',
    data: [{ value: [85, 70, 90, 65, 80], name: 'Car A' }]
  }]
});

Радар с несколькими сериями

Несколько записей данных рисуют перекрывающиеся многоугольники — идеально для сравнения. У каждой записи должно быть уникальное имя, совпадающее с легендой. Слишком много серий (5+) делает радар нечитаемым: многоугольники сливаются в пятно. Для ясности держитесь 2-4 объектов.

echarts
chart.setOption({
  legend: { data: ['Car A', 'Car B'] },
  radar: {
    indicator: [
      { name: 'Speed', max: 100 },
      { name: 'Power', max: 100 },
      { name: 'Range', max: 100 }
    ]
  },
  series: [{
    type: 'radar',
    data: [
      { value: [85, 70, 90], name: 'Car A' },
      { value: [60, 95, 75], name: 'Car B' }
    ]
  }]
});

Радар с областью

areaStyle заливает многоугольник полупрозрачным цветом, и форма читается легче. lineStyle подчёркивает контур. Держите прозрачность areaStyle низкой (0.2-0.4), чтобы перекрывающиеся серии оставались видны. Маркеры отмечают каждую вершину.

echarts
chart.setOption({
  radar: {
    indicator: [
      { name: 'A', max: 100 },
      { name: 'B', max: 100 },
      { name: 'C', max: 100 }
    ]
  },
  series: [{
    type: 'radar',
    data: [{ value: [85, 70, 90], name: 'Score' }],
    areaStyle: { opacity: 0.3 },
    lineStyle: { width: 2 },
    symbol: 'circle',
    symbolSize: 6
  }]
});

Форма и оси радара

shape: 'polygon' (по умолчанию) даёт угловатые оси; 'circle' — плавные кольца. splitNumber управляет плотностью сетки. splitArea чередует цвета для эффекта зебры. axisName стилизует подписи осей. Эти опции меняют визуальную структуру графика, не затрагивая данные.

echarts
chart.setOption({
  radar: {
    shape: 'polygon',          // 'polygon' or 'circle'
    radius: '65%',
    splitNumber: 5,            // grid ring count
    axisName: {
      color: '#333',
      fontSize: 12
    },
    splitLine: { lineStyle: { color: '#ccc' } },
    splitArea: {
      areaStyle: { color: ['#fafafa', '#fff'] }
    },
    indicator: [
      { name: 'Speed', max: 100 },
      { name: 'Power', max: 100 }
    ]
  },
  series: [{ type: 'radar', data: [{ value: [80, 70] }] }]
});

Внутренний радиус радара

radius: [inner, outer] создаёт кольцевой радар (как кольцо). center позиционирует график. min у индикатора задаёт начало оси — полезно, когда все значения высокие (иначе многоугольник сжимается в центре). Сдвигайте center, оставляя место для подписей осей.

echarts
chart.setOption({
  radar: {
    indicator: [
      { name: 'A', max: 100, min: 0 },   // min sets the inner bound
      { name: 'B', max: 100 },
      { name: 'C', max: 100 }
    ],
    radius: ['20%', '70%'],   // [inner, outer] for ring radar
    center: ['50%', '55%']
  },
  series: [{
    type: 'radar',
    data: [{ value: [60, 70, 80] }]
  }]
});
07

Тепловые карты

Декартова тепловая карта

Декартовой тепловой карте нужен visualMap для раскраски ячеек. Данные — [x, y, value]. label: { show: true } печатает значения в ячейках (хорошо только для небольших сеток). calculable: true добавляет ползунок. Тепловые карты показывают закономерности плотности (например, активность по часам).

echarts
const hours = ['12a','1a','2a','3a','4a','5a','6a','7a','8a','9a','10a','11a'];
const days = ['Sat','Sun','Mon','Tue','Wed','Thu','Fri'];

// data: [x, y, value]
const data = [[0,0,5],[0,1,1],[1,0,8] /* ... */];

chart.setOption({
  tooltip: {},
  xAxis: { type: 'category', data: hours },
  yAxis: { type: 'category', data: days },
  visualMap: {
    min: 0, max: 10,
    calculable: true,
    orient: 'horizontal',
    left: 'center', bottom: '5%'
  },
  series: [{
    type: 'heatmap',
    data: data,
    label: { show: true }
  }]
});

Календарная тепловая карта

Календарная тепловая карта показывает дневные значения за год (график вкладов в стиле GitHub). calendar.range задаёт год или диапазон дат. Точки данных — [dateString, value]. Градиент visualMap задаёт цветовые остановки. cellSize управляет размером квадрата: 'auto' подстраивается под контейнер.

echarts
const data = [];
// generate one year of data
for (let i = 0; i < 365; i++) {
  const date = new Date(2024, 0, 1);
  date.setDate(date.getDate() + i);
  data.push([date.toISOString().slice(0,10), Math.floor(Math.random() * 100)]);
}

chart.setOption({
  tooltip: {},
  visualMap: {
    min: 0, max: 100,
    inRange: { color: ['#ebedf0', '#c6e48b', '#7bc96f', '#239a3b', '#196127'] }
  },
  calendar: {
    range: '2024',
    cellSize: ['auto', 13],
    yearLabel: { show: true }
  },
  series: [{ type: 'heatmap', data: data }]
});

Стиль ячеек тепловой карты

itemStyle.borderColor и borderWidth создают эффект разделителей сетки (белые границы делают ячейки различимыми). borderRadius скругляет углы ячеек. Стили emphasis применяются при наведении. Скрытый visualMap (show: false) всё равно задаёт цвета, но не показывает легенду.

echarts
chart.setOption({
  xAxis: { type: 'category', data: ['A','B','C','D'] },
  yAxis: { type: 'category', data: ['X','Y','Z'] },
  visualMap: { min: 0, max: 100, show: false },
  series: [{
    type: 'heatmap',
    data: [[0,0,80],[0,1,30],[1,0,50]],
    itemStyle: {
      borderColor: '#fff',       // white grid lines
      borderWidth: 2,
      borderRadius: 4
    },
    emphasis: {
      itemStyle: { shadowBlur: 10 }
    }
  }]
});

Тепловая карта punch card

Punch card — это тепловая карта 7x24, показывающая активность по дню недели и часу. Каждая ячейка — временной слот. Скруглённый itemStyle делает её похожей на точки. Punch card выявляет недельные паттерны (например, когда сервер загружен сильнее всего). Данные — полная сетка из 168 ячеек.

echarts
const data = [];
for (let day = 0; day < 7; day++) {
  for (let hour = 0; hour < 24; hour++) {
    data.push([hour, day, Math.floor(Math.random() * 50) + 1]);
  }
}

chart.setOption({
  xAxis: { type: 'category', data: Array.from({length:24}, (_,i) => i + 'h') },
  yAxis: { type: 'category', data: ['Sun','Mon','Tue','Wed','Thu','Fri','Sat'] },
  visualMap: { max: 50, inRange: { color: ['#fff', '#5470c6'] } },
  series: [{
    type: 'heatmap',
    data: data,
    itemStyle: { borderRadius: 10, borderWidth: 2, borderColor: '#fff' }
  }]
});

Тепловая карта на географической карте

Сочетание geo с map-серией раскрашивает регионы по значению. visualMap задаёт цветовую шкалу. Сначала нужно зарегистрировать карту через echarts.registerMap('china', geoJson). roam: true включает панорамирование и зум. Так строят хороплеты (раскраска по регионам).

echarts
// requires a registered geo map (e.g. echarts.registerMap)
chart.setOption({
  geo: { map: 'china', roam: true },
  visualMap: {
    min: 0, max: 1000,
    inRange: { color: ['#e0ecf4', '#005824'] }
  },
  series: [{
    type: 'map',
    map: 'china',
    data: [
      { name: 'Beijing', value: 800 },
      { name: 'Shanghai', value: 950 }
    ]
  }]
});
08

Диаграммы-деревья

Базовое дерево (вертикальное)

Дерево отображает иерархические данные. layout: 'orthogonal' с orient: 'LR' даёт дерево слева направо. expandAndCollapse позволяет кликом сворачивать и разворачивать поддеревья. leaves настраивает стиль листьев. Дерево идеально для оргструктур, файловых деревьев и таксономий.

echarts
const data = {
  name: 'Root',
  children: [
    {
      name: 'Child A',
      children: [{ name: 'A1' }, { name: 'A2' }]
    },
    {
      name: 'Child B',
      children: [{ name: 'B1' }]
    }
  ]
};

chart.setOption({
  series: [{
    type: 'tree',
    data: [data],
    top: '5%', left: '10%', bottom: '5%', right: '20%',
    layout: 'orthogonal',       // 'orthogonal' or 'radial'
    orient: 'LR',               // 'LR','RL','TB','BT'
    symbolSize: 10,
    label: { position: 'left' },
    leaves: { label: { position: 'right' } },
    expandAndCollapse: true,
    animationDuration: 550
  }]
});

Горизонтальное дерево

orient: 'LR' даёт горизонтальное дерево (корень слева, листья справа). Подписи внутренних узлов стоят СЛЕВА от узла, листьев — СПРАВА: так они не перекрываются с ветвями. curveness у lineStyle делает соединители изогнутыми и мягкими.

echarts
chart.setOption({
  series: [{
    type: 'tree',
    data: [treeData],
    layout: 'orthogonal',
    orient: 'LR',              // left to right
    symbol: 'emptyCircle',
    symbolSize: 7,
    label: { position: 'left', verticalAlign: 'middle', align: 'right' },
    leaves: { label: { position: 'right', align: 'left' } },
    lineStyle: { color: '#999', width: 1, curveness: 0.5 }
  }]
});

Радиальное дерево

layout: 'radial' помещает корень в центр и разводит потомков по кругу. Это хорошо для больших деревьев, где горизонтальная раскладка была бы слишком широкой. emphasis.focus: 'descendant' подсвечивает всех потомков при наведении, помогая проследить ветви.

echarts
chart.setOption({
  series: [{
    type: 'tree',
    data: [treeData],
    layout: 'radial',          // circular layout
    symbol: 'circle',
    symbolSize: 8,
    label: {
      position: 'inside',
      rotate: 0
    },
    leaves: { label: { position: 'right' } },
    emphasis: { focus: 'descendant' },
    lineStyle: { curveness: 0.5 }
  }]
});

Дерево с собственными символами

symbol и symbolSize принимают функции для настройки каждого узла. Здесь внутренние узлы (с детьми) — крупные прямоугольники, а листья — маленькие круги. Так уровни иерархии различаются визуально. Сочетайте с orient: 'TB' для классической оргструктуры сверху вниз.

echarts
const treeData = {
  name: 'CEO',
  value: 'Boss',
  children: [
    { name: 'VP Engineering', children: [{ name: 'Eng Lead' }] },
    { name: 'VP Sales', children: [{ name: 'Sales Lead' }] }
  ]
};

chart.setOption({
  series: [{
    type: 'tree',
    data: [treeData],
    symbol: function (params) {
      // custom symbol per node
      return params.data.children ? 'rect' : 'circle';
    },
    symbolSize: function (params) {
      return params.data.children ? 15 : 8;
    },
    orient: 'TB',
    label: { position: 'top', distance: 8 }
  }]
});

Управление сворачиванием дерева

initialTreeDepth задаёт, сколько уровней открыто изначально (null — все, 0 — только корень). Клик по узлу с детьми сворачивает и разворачивает его поддерево. Событие click позволяет реагировать на выбор узла — удобно для drill-down интерфейсов. animationDurationUpdate сглаживает анимацию.

echarts
chart.setOption({
  series: [{
    type: 'tree',
    data: [treeData],
    expandAndCollapse: true,
    initialTreeDepth: 2,        // expand first 2 levels
    collapse: 'collapseBtn',
    symbol: 'circle',
    animationDurationUpdate: 750
  }]
});

// programmatic control via API
chart.on('click', function (params) {
  if (params.componentType === 'series') {
    console.log('Node clicked:', params.data.name);
    console.log('Collapsed:', params.data.collapsed);
  }
});
09

Диаграммы-солнце

Базовый sunburst

Sunburst — это радиальное дерево, где каждое кольцо соответствует уровню иерархии. Внутреннее — родитель, внешнее — дети. Значение узла задаёт его угловой размер. radius: [0, '90%'] даёт полный диск; [inner, outer] — кольцевой sunburst. Отлично для визуализации иерархических пропорций.

echarts
const data = [{
  name: 'Root',
  children: [
    {
      name: 'A',
      value: 15,
      children: [{ name: 'A1', value: 5 }, { name: 'A2', value: 10 }]
    },
    {
      name: 'B',
      value: 20,
      children: [{ name: 'B1', value: 20 }]
    }
  ]
}];

chart.setOption({
  series: [{
    type: 'sunburst',
    data: data,
    radius: [0, '90%'],
    label: { rotate: 'radial' }
  }]
});

Sunburst с уровнями

levels настраивает каждое кольцо отдельно: первая запись — корень, последующие — более глубокие уровни. r0/r задают внутренний и внешний радиусы для уровня. Разные повороты подписей (radial, tangential, 0) сохраняют читаемость на каждой глубине. Это даёт тонкий контроль над стилями.

echarts
chart.setOption({
  series: [{
    type: 'sunburst',
    data: sunburstData,
    radius: ['15%', '90%'],
    levels: [
      {},  // root level (default)
      {
        r0: '15%',
        r: '45%',
        label: { rotate: 0, fontSize: 14 },
        itemStyle: { borderWidth: 2 }
      },
      {
        r0: '45%',
        r: '70%',
        label: { rotate: 'tangential', fontSize: 12 }
      },
      {
        r0: '70%',
        r: '90%',
        label: { rotate: 'radial', fontSize: 10 }
      }
    ]
  }]
});

Стиль и подсветка sunburst

emphasis.focus: 'ancestor' подсвечивает путь от узла под курсором обратно к корню — пользователь видит, где сектор находится в иерархии. borderWidth разделяет сектора визуально. Sunburst интерактивен: клик обычно означает углубление. Подсветка предков помогает не терять контекст в глубоких деревьях.

echarts
chart.setOption({
  series: [{
    type: 'sunburst',
    data: data,
    itemStyle: {
      borderColor: '#fff',
      borderWidth: 1
    },
    emphasis: {
      focus: 'ancestor'    // highlight ancestors on hover
    },
    highlight: {
      itemStyle: { color: '#ffb' }
    }
  }]
});

Sunburst со значениями и сортировкой

sort управляет порядком секторов внутри родителя. nodeClick: 'zoomToNode' приближает выбранное поддерево (удобно для исследования). minAngle скрывает подписи на секторах меньше 5 градусов, избегая мусора. Значение родительских узлов автоматически суммируется из детей, если не задано.

echarts
chart.setOption({
  series: [{
    type: 'sunburst',
    data: [{
      name: 'Root',
      children: [
        { name: 'A', value: 30, children: [/* ... */] },
        { name: 'B', value: 70, children: [/* ... */] }
      ]
    }],
    nodeClick: 'zoomToNode',   // click to zoom into subtree
    sort: 'desc',              // or 'asc', null
    label: { minAngle: 5 }     // hide labels on tiny slices
  }]
});

Drill-down в sunburst

Собственные обработчики клика позволяют построить свой drill-down. Замените данные на выбранный узел, чтобы приблизиться. Сохраните ссылку на родителя, если нужна кнопка «назад». Drill-down в sunburst отлично подходит для изучения глубоких иерархий без перегрузки экрана.

echarts
const data = [/* full tree */];
let currentRoot = data[0];

chart.setOption({
  series: [{
    type: 'sunburst',
    data: data,
    nodeClick: false
  }]
});

chart.on('click', function (params) {
  if (params.componentType === 'series' && params.data.children) {
    // manually drill down
    currentRoot = params.data;
    chart.setOption({
      series: [{ data: [currentRoot] }]
    }, { notMerge: true });
  }
});
10

Диаграммы Санкея

Базовый Sankey

Sankey показывает потоки между узлами. data — узлы (с именами); links — потоки (source, target, value). Ширина каждой связи пропорциональна значению. emphasis.focus: 'adjacency' подсвечивает связанные узлы при наведении. Отлично для визуализации энергии, денег или пользовательских потоков.

echarts
chart.setOption({
  series: [{
    type: 'sankey',
    data: [
      { name: 'Source A' },
      { name: 'Source B' },
      { name: 'Mid C' },
      { name: 'Sink D' }
    ],
    links: [
      { source: 'Source A', target: 'Mid C', value: 5 },
      { source: 'Source B', target: 'Mid C', value: 3 },
      { source: 'Mid C', target: 'Sink D', value: 8 }
    ],
    emphasis: { focus: 'adjacency' },
    lineStyle: { color: 'gradient', curveness: 0.5 }
  }]
});

Уровни узлов Sankey

levels стилизует узлы по глубине (колонке). lineStyle.color: 'source' окрашивает связи в цвет исходного узла; 'target' — в цвет целевого; 'gradient' смешивает. nodeAlign выравнивает узлы по вертикали внутри колонки. Явный depth принудительно задаёт колонку, переопределяя авто-раскладку.

echarts
chart.setOption({
  series: [{
    type: 'sankey',
    data: [
      { name: 'A', depth: 0 },
      { name: 'B', depth: 1 },
      { name: 'C', depth: 2 }
    ],
    links: [
      { source: 'A', target: 'B', value: 10 },
      { source: 'B', target: 'C', value: 10 }
    ],
    levels: [
      { depth: 0, itemStyle: { color: '#fbb' }, lineStyle: { color: 'source' } },
      { depth: 1, itemStyle: { color: '#bfb' }, lineStyle: { color: 'target' } },
      { depth: 2, itemStyle: { color: '#bbf' } }
    ],
    nodeAlign: 'justify'      // 'left','right','justify'
  }]
});

Стиль узлов и зазоры Sankey

nodeWidth задаёт толщину прямоугольника узла. nodeGap управляет вертикальными промежутками. Меньшие зазоры показывают больше узлов, но могут привести к наложению. lineStyle.opacity делает потоки приглушёнными, чтобы узлы выделялись. label.position: 'right' ставит подписи рядом с узлами — типично для потоков слева направо.

echarts
chart.setOption({
  series: [{
    type: 'sankey',
    data: nodes,
    links: links,
    nodeWidth: 20,            // width of each node rectangle
    nodeGap: 10,              // vertical gap between nodes
    nodeAlign: 'justify',
    label: {
      fontSize: 12,
      color: '#333',
      position: 'right'
    },
    lineStyle: { opacity: 0.4 },
    itemStyle: { borderWidth: 0 }
  }]
});

Sankey с циклом (drain)

Настоящие циклы ломают Sankey в ECharts. Обходной путь — разбить рециркулирующий узел на отдельные узлы «вход» и «выход» (например, «Recycle»), чтобы поток стал ацикличным. Так визуально показывают обратные связи. Всегда проверяйте сохранение потока: сумма входов узла должна равняться сумме выходов.

echarts
// Sankey normally forbids cycles, but you can show feedback loops
// by splitting a node into two (in & out) with the same name suffix
chart.setOption({
  series: [{
    type: 'sankey',
    data: [
      { name: 'Input' },
      { name: 'Process' },
      { name: 'Output' },
      { name: 'Recycle' }
    ],
    links: [
      { source: 'Input', target: 'Process', value: 100 },
      { source: 'Process', target: 'Output', value: 80 },
      { source: 'Process', target: 'Recycle', value: 20 },
      { source: 'Recycle', target: 'Process', value: 20 }
    ],
    emphasis: { focus: 'adjacency' }
  }]
});

Интерактивность Sankey

События клика в Sankey различают узлы и связи через dataType. Это позволяет строить панели деталей с описанием потока. label.formatter: '{b}: {c}' показывает имя и значение. Фокус adjacency подсвечивает весь путь через узел под курсором, выявляя цепочки причин и следствий.

echarts
chart.setOption({
  series: [{
    type: 'sankey',
    data: nodes,
    links: links,
    emphasis: {
      focus: 'adjacency',
      lineStyle: { opacity: 0.8 }
    },
    label: { formatter: '{b}: {c}' },
    tooltip: { trigger: 'item' }
  }]
});

chart.on('click', function (params) {
  if (params.dataType === 'edge') {
    console.log('Flow from', params.data.source, 'to', params.data.target);
    console.log('Value:', params.data.value);
  } else if (params.dataType === 'node') {
    console.log('Node:', params.data.name);
  }
});
11

Воронки

Базовая воронка

Воронка показывает этапы процесса, на каждом из которых элементов меньше. sort: 'descending' (по умолчанию) ставит самый большой этап наверх. Данные должны идти в порядке процесса. Воронки идеальны для sales pipeline, анализа конверсии и шагов онбординга.

echarts
chart.setOption({
  series: [{
    type: 'funnel',
    data: [
      { value: 100, name: 'Visit' },
      { value: 75, name: 'Sign Up' },
      { value: 50, name: 'Trial' },
      { value: 25, name: 'Purchase' }
    ],
    sort: 'descending'      // 'descending','ascending','none'
  }]
});

Воронка с сортировкой и зазорами

sort: 'ascending' переворачивает воронку (наименьший этап наверху, как график роста). gap разделяет секции для читаемости. funnelAlign выравнивает секции по горизонтали. minSize/maxSize ограничивают ширину секций в процентах, чтобы крошечные этапы оставались видимыми.

echarts
chart.setOption({
  series: [{
    type: 'funnel',
    data: data,
    sort: 'ascending',          // smallest at top
    gap: 4,                     // pixel gap between slices
    funnelAlign: 'center',      // 'left','center','right'
    width: '60%',
    minSize: '20%',
    maxSize: '100%'
  }]
});

Подписи воронки

position: 'inside' накладывает подписи на секции; 'left'/'right' выносит их наружу с соединительными линиями (labelLine). formatter: '{b}: {c}' показывает имя и значение. Внешние подписи используйте, когда секции слишком тонкие для текста внутри. Emphasis увеличивает подпись при наведении.

echarts
chart.setOption({
  series: [{
    type: 'funnel',
    data: data,
    label: {
      show: true,
      position: 'inside',      // 'inside','left','right'
      formatter: '{b}: {c}'
    },
    labelLine: {
      show: true,
      length: 20,
      lineStyle: { width: 1, type: 'solid' }
    },
    emphasis: {
      label: { fontSize: 16 }
    }
  }]
});

Стиль секций воронки

itemStyle для отдельной секции переопределяет стандартный цикл цветов. borderColor визуально разделяет секции. Цвет можно задать и в отдельном элементе data. Для аккуратного вида используйте последовательную палитру (светлее для ранних этапов, темнее для конверсии), чтобы усилить метафору воронки.

echarts
chart.setOption({
  series: [{
    type: 'funnel',
    data: [
      { value: 100, name: 'A', itemStyle: { color: '#5470c6' } },
      { value: 75, name: 'B', itemStyle: { color: '#91cc75' } },
      { value: 50, name: 'C', itemStyle: { color: '#fac858' } }
    ],
    itemStyle: {
      borderColor: '#fff',
      borderWidth: 2,
      borderRadius: 0
    }
  }]
});

Сравнительная воронка

Несколько серий воронки можно расположить рядом для сравнения периодов. Задайте каждой серии свои left/width для позиционирования. Это отлично для визуализации A/B-тестов или сравнения конверсии год к году. Используйте контрастные цвета серий, чтобы их различать.

echarts
chart.setOption({
  series: [
    {
      type: 'funnel',
      name: '2023',
      data: [{ value: 100, name: 'A' }, { value: 40, name: 'B' }],
      sort: 'descending',
      left: '5%', width: '40%',
      label: { position: 'inside' }
    },
    {
      type: 'funnel',
      name: '2024',
      data: [{ value: 120, name: 'A' }, { value: 60, name: 'B' }],
      sort: 'descending',
      left: '55%', width: '40%',
      label: { position: 'inside' }
    }
  ]
});
12

Индикаторы (gauge)

Базовый индикатор

Gauge показывает одно значение на дуге. min/max задают шкалу. progress рисует цветную дугу до значения (axisLine служит дорожкой). detail выводит текст значения в центре. valueAnimation плавно меняет число. Отлично для KPI и дашбордов с одной метрикой.

echarts
chart.setOption({
  series: [{
    type: 'gauge',
    min: 0,
    max: 100,
    progress: { show: true, width: 18 },
    axisLine: { lineStyle: { width: 18 } },
    detail: {
      valueAnimation: true,
      formatter: '{value}%'
    },
    data: [{ value: 70, name: 'Score' }]
  }]
});

Индикатор со стрелкой

Стрелка — классический вид индикатора. anchor — центральный штифт. Отрицательные значения distance сдвигают деления и подписи внутрь, к центру. radius масштабирует весь индикатор. Сочетайте стрелку с splitLine, чтобы имитировать физический прибор. Полезно, когда нужен аналоговый вид.

echarts
chart.setOption({
  series: [{
    type: 'gauge',
    radius: '60%',
    min: 0, max: 100,
    pointer: { show: true, length: '60%', width: 5 },
    anchor: { show: true, size: 12, itemStyle: { color: '#333' } },
    axisTick: { distance: -15, length: 5 },
    splitLine: { distance: -20, length: 10 },
    axisLabel: { distance: -25 },
    data: [{ value: 42 }]
  }]
});

Индикатор с цветовыми зонами

axisLine.lineStyle.color принимает массив пар [порог, цвет], создавая цветные зоны (например, красный/жёлтый/зелёный для уровней риска). Пороги — доли от 0 до 1. Это стандартный способ показать диапазоны «безопасно/предупреждение/опасно». Стрелка или дуга progress показывает текущее значение внутри зон.

echarts
chart.setOption({
  series: [{
    type: 'gauge',
    min: 0, max: 100,
    axisLine: {
      lineStyle: {
        width: 20,
        color: [
          [0.3, '#fd666d'],    // 0-30% red
          [0.7, '#37a2da'],    // 30-70% blue
          [1, '#91cc75']       // 70-100% green
        ]
      }
    },
    data: [{ value: 85 }]
  }]
});

Индикатор с несколькими стрелками

Несколько записей data создают несколько стрелок на одном индикаторе. Полезно для сравнения связанных метрик (CPU, память, диск). Каждое значение анимируется независимо. Держите число небольшим (3-5 максимум), иначе индикатор становится перегруженным. Имена показываются как подписи у стрелок.

echarts
chart.setOption({
  series: [{
    type: 'gauge',
    min: 0, max: 100,
    data: [
      { value: 60, name: 'CPU' },
      { value: 40, name: 'Memory' },
      { value: 80, name: 'Disk' }
    ],
    detail: { formatter: '{value}%' },
    title: { fontSize: 14 }
  }]
});

Свой индикатор (круговой прогресс)

startAngle/endAngle на 360° создают кольцо прогресса (как кольца Apple Watch). Скрытые стрелка, деления и подписи дают чистый минималистичный вид. roundCap скругляет концы прогресса. Этот стиль популярен в современных дашбордах: по сути это индикатор, замаскированный под кольцо.

echarts
chart.setOption({
  series: [{
    type: 'gauge',
    startAngle: 90,
    endAngle: -270,            // full circle
    pointer: { show: false },
    progress: {
      show: true,
      overlap: false,
      roundCap: true,
      clip: false
    },
    axisLine: { lineStyle: { width: 20, color: [[1, 'rgba(0,0,0,0.1)']] } },
    splitLine: { show: false },
    axisTick: { show: false },
    axisLabel: { show: false },
    detail: {
      valueAnimation: true,
      offsetCenter: ['0%', '0%'],
      fontSize: 30,
      formatter: '{value}%'
    },
    data: [{ value: 65 }]
  }]
});
13

Системы координат

Несколько осей X

xAxis — это массив, каждая запись задаёт отдельную ось. Серии привязываются к оси через xAxisIndex (с нуля). Так один график показывает две метрики с разными шкалами или единицами. position ставит оси сверху или снизу. Часто используется в биржевых графиках (цена + объём) или погоде (температура + влажность).

echarts
chart.setOption({
  xAxis: [
    { type: 'category', data: ['A','B','C'], position: 'bottom' },
    { type: 'category', data: ['A','B','C'], position: 'top', axisLine: { onZero: false } }
  ],
  yAxis: { type: 'value' },
  series: [
    { type: 'line', data: [10, 20, 30], xAxisIndex: 0 },
    { type: 'line', data: [50, 60, 70], xAxisIndex: 1 }
  ]
});

Две оси Y

Две оси Y (слева и справа) позволяют строить серии с разными единицами (например, выручка в рублях и штуки продаж). Каждая серия привязывается к оси через yAxisIndex. Подкрасьте линию правой оси в цвет её серии, чтобы было понятно, какая линия к какой оси относится. Избегайте 3+ осей — они путают.

echarts
chart.setOption({
  xAxis: { type: 'category', data: ['Mon','Tue','Wed','Thu'] },
  yAxis: [
    { type: 'value', name: 'Sales', position: 'left' },
    { type: 'value', name: 'Orders', position: 'right', axisLine: { lineStyle: { color: '#ee6666' } } }
  ],
  series: [
    { type: 'bar', data: [200, 180, 250, 210], yAxisIndex: 0 },
    { type: 'line', data: [40, 35, 50, 42], yAxisIndex: 1, smooth: true }
  ]
});

Полярные координаты

Полярные координаты используют angleAxis (по кругу) и radiusAxis (от центра). Серии задают coordinateSystem: 'polar'. startAngle: 90 помещает 0° наверх (на север). Полярные координаты хороши для направленных данных (роза ветров), циклических паттернов и вариантов розы/Найтингейл.

echarts
chart.setOption({
  polar: {},
  angleAxis: {
    type: 'category',
    data: ['N','NE','E','SE','S','SW','W','NW'],
    startAngle: 90
  },
  radiusAxis: { type: 'value' },
  series: [{
    type: 'bar',
    data: [1, 2, 3, 4, 5, 6, 7, 8],
    coordinateSystem: 'polar'
  }]
});

Календарные координаты

Система координат calendar отображает даты в ячейки. Серии с coordinateSystem: 'calendar' привязываются к ней. cellSize может быть в пикселях или 'auto'. orient: 'horizontal' — стандартная раскладка по неделям. dayLabel/monthLabel с nameMap локализуют подписи. Сочетайте с heatmap для графиков вкладов.

echarts
chart.setOption({
  calendar: {
    range: ['2024-01-01', '2024-12-31'],
    cellSize: ['auto', 15],
    left: 50, right: 30,
    orient: 'horizontal',
    dayLabel: { nameMap: 'en' },
    monthLabel: { nameMap: 'en' },
    yearLabel: { show: false }
  },
  series: [{
    type: 'heatmap',
    coordinateSystem: 'calendar',
    data: calendarData
  }]
});

Параллельные координаты

Параллельные координаты показывают многомерные данные: по одной оси на измерение. Каждая строка данных становится ломаной, пересекающей все оси. Это выявляет корреляции и кластеры в многомерных данных (например, сравнение машин по цене, пробегу, году, безопасности). Полезно для исследования данных.

echarts
chart.setOption({
  parallelAxis: [
    { dim: 0, name: 'Price' },
    { dim: 1, name: 'Mileage' },
    { dim: 2, name: 'Year' },
    { dim: 3, name: 'Safety', type: 'category', data: ['Low','Med','High'] }
  ],
  parallel: {
    parallelAxisDefault: {
      axisLine: { lineStyle: { color: '#999' } },
      nameTextStyle: { color: '#333' }
    }
  },
  series: [{
    type: 'parallel',
    data: [[20000, 30, 2020, 'High'], [25000, 25, 2021, 'Med']]
  }]
});

Настройка географической карты

registerMap связывает GeoJSON с именем для использования в geo и map-сериях. roam включает панорамирование и зум мышью. itemStyle.areaColor заливает регионы; borderColor рисует границы. Стили emphasis применяются при наведении. Одна geo показывает карту; добавьте map-серию, чтобы раскрасить регионы по значению (хороплет).

echarts
// load a map GeoJSON (must be registered before use)
fetch('https://geo.datav.aliyun.com/areas_v3/bound/100000_full.json')
  .then(r => r.json())
  .then(geoJson => {
    echarts.registerMap('china', geoJson);
    chart.setOption({
      geo: {
        map: 'china',
        roam: true,                  // pan & zoom
        zoom: 1.2,
        label: { show: false },
        itemStyle: {
          areaColor: '#eee',
          borderColor: '#fff'
        },
        emphasis: {
          label: { show: true },
          itemStyle: { areaColor: '#f5f5f5' }
        }
      }
    });
  });
14

Dataset

Базовый dataset

Dataset отделяет данные от конфигурации серий. source — двумерный массив (первая строка — заголовки). seriesLayoutBy: 'column' заставляет каждую серию брать столбец. encode сопоставляет столбцы dataset с осями x/y. Так данные отделяются от представления — удобно, когда один набор используется в нескольких графиках.

echarts
chart.setOption({
  dataset: {
    source: [
      ['product', '2023', '2024'],
      ['Apple', 41, 56],
      ['Banana', 67, 28],
      ['Cherry', 89, 76]
    ]
  },
  xAxis: { type: 'category' },
  yAxis: {},
  series: [
    { type: 'bar', seriesLayoutBy: 'column', encode: { x: 'product', y: '2023' } },
    { type: 'bar', seriesLayoutBy: 'column', encode: { x: 'product', y: '2024' } }
  ]
});

Dataset со строками-объектами

source может быть массивом объектов (строки ключ-значение). dimensions необязательно объявляет столбцы (полезно, если в строках могут отсутствовать ключи). encode использует имена измерений вместо индексов — так читаемее. Строки-объекты проще писать вручную и они сами себя документируют.

echarts
chart.setOption({
  dataset: {
    dimensions: ['product', 'count', 'score'],
    source: [
      { product: 'Apple', count: 41, score: 90 },
      { product: 'Banana', count: 67, score: 75 },
      { product: 'Cherry', count: 89, score: 88 }
    ]
  },
  xAxis: { type: 'category' },
  yAxis: {},
  series: [
    { type: 'bar', encode: { x: 'product', y: 'count' } },
    { type: 'bar', encode: { x: 'product', y: 'score' } }
  ]
});

Трансформации dataset (фильтр и сортировка)

Трансформации образуют цепочки dataset: filter убирает строки, sort упорядочивает. Каждая трансформация читает fromDatasetId и создаёт новый dataset. Серии привязываются через datasetId. Трансформации позволяют получать представления из одного источника без копирования данных. Поддерживаются filter, sort и свои через registerTransform.

echarts
chart.setOption({
  dataset: [
    {
      id: 'raw',
      source: [
        { product: 'A', sales: 100 },
        { product: 'B', sales: 50 },
        { product: 'C', sales: 200 }
      ]
    },
    {
      id: 'filtered',
      fromDatasetId: 'raw',
      transform: {
        type: 'filter',
        config: { and: [{ gte: { sales: 80 } }] }
      }
    },
    {
      id: 'sorted',
      fromDatasetId: 'filtered',
      transform: { type: 'sort', config: { order: 'desc', main: 'sales' } }
    }
  ],
  xAxis: { type: 'category' },
  yAxis: {},
  series: [{ type: 'bar', datasetId: 'sorted', encode: { x: 'product', y: 'sales' } }]
});

Encode и измерения dataset

encode сопоставляет столбцы dataset (по индексу или имени) с измерениями графика. encode.tooltip перечисляет столбцы для всплывающей подсказки. Здесь столбцы 0/1 задают позицию, 2 — размер, 3 — цвет (через itemStyle). Кодирование делает один dataset пригодным для разных типов графиков.

echarts
chart.setOption({
  dataset: {
    source: [
      [10, 20, 30, 'red'],
      [15, 25, 35, 'blue'],
      [20, 30, 40, 'green']
    ]
  },
  xAxis: { type: 'value' },
  yAxis: { type: 'value' },
  series: [{
    type: 'scatter',
    encode: {
      x: 0,                  // first column -> x
      y: 1,                  // second column -> y
      tooltip: [0, 1, 2]     // show these in tooltip
    },
    symbolSize: function (d) { return d[2]; }
  }]
});

Dataset для круговой диаграммы

Круговым диаграммам нужны сопоставления itemName и value через encode. Один и тот же dataset может питать и столбчатый график (encode x:name, y:value), и круговую диаграмму с другим кодированием. В этом сила dataset: один источник — несколько представлений. Смена типа графика меняет только тип серии и encode.

echarts
chart.setOption({
  dataset: {
    source: [
      { name: 'Search', value: 1048 },
      { name: 'Direct', value: 735 },
      { name: 'Email', value: 580 }
    ]
  },
  series: [{
    type: 'pie',
    radius: '60%',
    encode: { itemName: 'name', value: 'value' }
  }]
});
15

VisualMap

Непрерывный visualMap

Непрерывный visualMap сопоставляет числовой диапазон с цветом (и при желании размером). inRange.color — градиент (интерполируется). calculable: true добавляет перетаскиваемые маркеры для фильтрации. orient и left/top задают положение. visualMap задаёт цвета серий — не нужно вручную ставить itemStyle.color.

echarts
chart.setOption({
  visualMap: {
    type: 'continuous',
    min: 0,
    max: 100,
    inRange: {
      color: ['#50a3ba', '#eac736', '#d94e5d'],
      symbolSize: [10, 50]
    },
    calculable: true,           // show slider handles
    orient: 'vertical',
    left: 'left', top: 'bottom'
  },
  series: [{
    type: 'scatter',
    data: [[10,20,30], [50,60,80], [80,90,95]]
  }]
});

Дискретный visualMap

Дискретный visualMap разбивает значения на интервалы, каждому свой цвет. pieces задаёт интервалы (min/max/label/color). Это понятнее градиента, когда нужны категориальные группы (например, низкий/средний/высокий риск). Полезно для хороплетов и категоризованных scatter-графиков.

echarts
chart.setOption({
  visualMap: {
    type: 'piecewise',
    pieces: [
      { min: 0, max: 30, label: 'Low', color: '#91cc75' },
      { min: 30, max: 70, label: 'Mid', color: '#fac858' },
      { min: 70, max: 100, label: 'High', color: '#ee6666' }
    ],
    orient: 'horizontal',
    left: 'center', bottom: 10
  },
  series: [{
    type: 'scatter',
    data: data
  }]
});

Категориальный visualMap

Категориальный visualMap сопоставляет строковые категории с цветами. categories перечисляет значения; inRange.color — соответствующие цвета по порядку. dimension выбирает столбец данных для сопоставления (по умолчанию 0). Отлично, когда в данных есть категориальный признак (приоритет, статус), который нужно окрасить.

echarts
chart.setOption({
  visualMap: {
    type: 'piecewise',
    categories: ['Low', 'Medium', 'High'],
    inRange: { color: ['#91cc75', '#fac858', '#ee6666'] },
    dimension: 2                  // which data column to map
  },
  series: [{
    type: 'scatter',
    data: [
      [10, 20, 'Low'],
      [50, 60, 'Medium'],
      [80, 90, 'High']
    ]
  }]
});

VisualMap и значения вне диапазона

outOfRange стилизует точки вне выбранного диапазона visualMap (например, серые при фильтрации). controller стилизует сам ползунок. Когда пользователь двигает ползунок для фильтрации, точки вне диапазона тускнеют до outOfRange.color. Так visualMap становится интерактивным фильтром, а не просто легендой.

echarts
chart.setOption({
  visualMap: {
    min: 0, max: 100,
    inRange: { color: ['#5470c6', '#91cc75'] },
    outOfRange: { color: '#ccc', symbolSize: 5 },  // filtered out style
    controller: {
      inRange: { color: ['#5470c6', '#91cc75'] }
    },
    right: 10, top: 'center'
  },
  series: [{
    type: 'scatter',
    data: data
  }]
});

VisualMap для нескольких серий

По умолчанию visualMap влияет на все серии. Используйте seriesIndex (число или массив), чтобы адресовать конкретные серии. Это позволяет окрасить одну серию, оставив другие без изменений, — удобно при сравнении выделенного набора с эталоном. На одном графике может быть даже несколько visualMap для разных серий.

echarts
chart.setOption({
  visualMap: {
    min: 0, max: 100,
    inRange: { color: ['#5470c6', '#91cc75', '#fac858'] }
  },
  series: [
    { type: 'scatter', name: 'A', data: dataA },
    { type: 'scatter', name: 'B', data: dataB }
  ]
});

// bind visualMap to specific series only
chart.setOption({
  visualMap: { seriesIndex: 1 }   // only affects second series
});
16

Легенда

Базовая легенда

Легенда перечисляет имена серий для переключения видимости. data должны совпадать с series.name (или выводятся автоматически). icon стилизует маркер. Клик по элементу легенды переключает его серию. Легенда автоматически обновляется при добавлении и удалении серий через setOption.

echarts
chart.setOption({
  legend: {
    data: ['Email', 'Search', 'Direct'],
    show: true,
    icon: 'roundRect',        // 'circle','rect','roundRect','triangle','diamond','pin','arrow'
    itemWidth: 20,
    itemHeight: 14,
    textStyle: { color: '#333', fontSize: 12 }
  },
  series: [
    { type: 'line', name: 'Email', data: [120, 200, 150] },
    { type: 'line', name: 'Search', data: [220, 180, 90] }
  ]
});

Положение и раскладка легенды

orient и top/left позиционируют легенду. Типичные раскладки: сверху по центру (по умолчанию), снизу по центру, справа вертикально. itemGap управляет расстоянием между элементами. Лёгкий фон или рамка визуально отделяют легенду от графика. Положение важно: легенда снизу освобождает вертикальное место.

echarts
chart.setOption({
  legend: {
    orient: 'horizontal',          // 'horizontal' or 'vertical'
    top: 'top',                    // 'top','bottom','middle' or px
    left: 'center',                // 'left','center','right' or px
    itemGap: 20,                   // gap between items
    padding: 5,
    backgroundColor: '#f5f5f5',
    borderColor: '#ddd',
    borderWidth: 1,
    borderRadius: 4
  },
  series: [/* ... */]
});

Выбор в легенде

selected задаёт начальную видимость. selectedMode: 'single' превращает легенду в радиокнопки (видна только одна серия). Событие legendselectchanged срабатывает при переключении — полезно для сохранения настроек или синхронизации нескольких графиков. Режим по умолчанию — 'multiple'.

echarts
chart.setOption({
  legend: {
    selected: {
      'Email': true,        // visible by default
      'Search': false,      // hidden by default
      'Direct': true
    },
    selectedMode: 'multiple'   // 'single' or 'multiple'
  },
  series: [
    { type: 'line', name: 'Email', data: [120, 200, 150] },
    { type: 'line', name: 'Search', data: [220, 180, 90] },
    { type: 'line', name: 'Direct', data: [100, 90, 80] }
  ]
});

chart.on('legendselectchanged', function (params) {
  console.log('Selected:', params.selected);
});

Прокручиваемая легенда

type: 'scroll' разбивает легенду на страницы, когда элементов слишком много, — появляются кнопки страниц. Это необходимо для графиков с 10+ сериями, которые иначе вылезут за край. Стили иконок и текста страниц настраиваются. Вертикальная прокручиваемая легенда хорошо вписывается в правое поле.

echarts
chart.setOption({
  legend: {
    type: 'scroll',           // 'plain' (default) or 'scroll'
    orient: 'vertical',
    right: 10, top: 20, bottom: 20,
    pageButtonItemStyle: { color: '#333' },
    pageIconColor: '#5470c6',
    pageIconInactiveColor: '#ccc',
    pageTextStyle: { color: '#333' },
    data: Array.from({length: 30}, (_, i) => 'Series ' + i)
  },
  series: [/* many series */]
});

Formatter и rich text в легенде

formatter настраивает подписи легенды (например, верхний регистр, добавление счётчиков). Rich text позволяет стилизовать части подписи по-разному: задайте стили в textStyle.rich и ссылайтесь на них в formatter синтаксисом {style|text}. Так получаются легенды вида 'A {count|42}' со смешанным оформлением.

echarts
chart.setOption({
  legend: {
    data: ['A', 'B'],
    formatter: function (name) {
      return name.toUpperCase();
    },
    textStyle: {
      rich: {
        a: { color: '#5470c6', fontSize: 14, fontWeight: 'bold' },
        b: { color: '#91cc75', fontSize: 12 }
      }
    }
  },
  series: [/* ... */]
});

// legend can also show values via legendselectchanged + setOption
chart.on('legendselectchanged', () => {
  // dynamic label updates
});
17

Tooltip

Базовый tooltip

trigger: 'item' показывает подсказку для отдельной точки (scatter, pie). 'axis' — для всей категории (bar, line). axisPointer рисует направляющую: 'shadow' — полупрозрачная полоса (хорошо для столбцов), 'line' — тонкая линия (хорошо для линий), 'cross' — обе линии, x и y.

echarts
chart.setOption({
  tooltip: {
    trigger: 'axis',           // 'item','axis','none'
    show: true,
    backgroundColor: 'rgba(50,50,50,0.9)',
    borderColor: '#333',
    borderWidth: 1,
    padding: 10,
    textStyle: { color: '#fff', fontSize: 13 },
    axisPointer: { type: 'shadow' }   // 'line','shadow','cross'
  },
  xAxis: { type: 'category', data: ['A','B','C'] },
  yAxis: { type: 'value' },
  series: [{ type: 'bar', data: [10, 20, 30] }]
});

Formatter tooltip

formatter настраивает содержимое подсказки. Функция получает params (с name, value, seriesName, color и т. д.) и возвращает HTML. Строковые шаблоны используют {a} (имя серии), {b} (категория/x), {c} (значение), {d} (процент для круговой). Для подсказок по оси с несколькими сериями params — массив, перебирайте его.

echarts
chart.setOption({
  tooltip: {
    trigger: 'item',
    formatter: function (params) {
      // params has: name, value, seriesName, color, dataIndex, ...
      return '<b>' + params.name + '</b><br/>' +
             'Value: ' + params.value + '<br/>' +
             'Series: ' + params.seriesName;
    }
  },
  series: [{ type: 'pie', data: [/* ... */] }]
});

// string template form (for axis trigger)
chart.setOption({
  tooltip: {
    trigger: 'axis',
    formatter: '{a}: {b} = {c}'   // a=series, b=category, c=value
  }
});

Crosshair и axis pointer

axisPointer.link верхнего уровня синхронизирует указатели между графиками (дашборды из нескольких графиков) — передайте xAxisIndex: 'all'. type: 'cross' показывает полный перекрестие с подписями по x и y. crossStyle/lineStyle настраивают направляющие. Синхронные указатели необходимы для сравнения данных на нескольких графиках.

echarts
chart.setOption({
  tooltip: { trigger: 'axis' },
  xAxis: { type: 'category', data: ['Mon','Tue','Wed','Thu'] },
  yAxis: { type: 'value' },
  axisPointer: {
    link: [{ xAxisIndex: 'all' }],   // sync pointers across charts
    label: { backgroundColor: '#333' }
  },
  series: [{ type: 'line', data: [10, 20, 30, 40] }]
});

// per-axis pointer type
chart.setOption({
  tooltip: {
    axisPointer: {
      type: 'cross',
      crossStyle: { color: '#999' },
      lineStyle: { color: '#999', type: 'dashed' }
    }
  }
});

Tooltip с trigger item

trigger: 'item' показывает подсказку при наведении на отдельную точку (сектор круга, точка scatter). Это режим по умолчанию для pie, scatter, radar. extraCssText добавляет произвольный CSS (тени, скругления) для своего оформления. Для круговых диаграмм доступен percent. Подсказки по элементу точны для каждой точки.

echarts
chart.setOption({
  tooltip: {
    trigger: 'item',               // per-point, not per-axis
    formatter: function (p) {
      return p.name + ': ' + p.value + ' (' + p.percent + '%)';
    },
    backgroundColor: 'rgba(255,255,255,0.95)',
    borderColor: '#eee',
    textStyle: { color: '#333' },
    extraCssText: 'box-shadow: 0 2px 10px rgba(0,0,0,0.1);'
  },
  series: [{
    type: 'pie',
    data: [{ value: 60, name: 'A' }, { value: 40, name: 'B' }]
  }]
});

Tooltip с rich-содержимым

Для подсказок по оси с несколькими сериями params — массив. Перебирайте его, чтобы построить богатую HTML-таблицу с цветными маркерами, значениями и форматированием. Так делают профессиональные подсказки с выравниванием, итогами и единицами. Возврат HTML даёт полный контроль над стилями через inline CSS.

echarts
chart.setOption({
  tooltip: {
    trigger: 'axis',
    axisPointer: { type: 'shadow' },
    formatter: function (params) {
      let html = '<div style="font-weight:bold;margin-bottom:4px;">'
        + params[0].name + '</div>';
      params.forEach(p => {
        html += '<div style="display:flex;align-items:center;">'
          + '<span style="display:inline-block;width:10px;height:10px;background:'
          + p.color + ';margin-right:6px;"></span>'
          + p.seriesName + ': ' + p.value
          + '</div>';
      });
      return html;
    }
  },
  series: [
    { type: 'bar', name: 'A', data: [10, 20, 30] },
    { type: 'bar', name: 'B', data: [15, 25, 35] }
  ]
});
18

Toolbox

Возможности toolbox

Toolbox добавляет иконки действий (по умолчанию справа сверху). dataZoom позволяет выделять область для зума. dataView показывает исходные данные (редактируемые при readOnly: false). magicType переключает тип графика (line/bar). restore сбрасывает настройки. saveAsImage экспортирует PNG/SVG. У каждой функции своя конфигурация.

echarts
chart.setOption({
  toolbox: {
    show: true,
    right: 10, top: 10,
    feature: {
      dataZoom: { yAxisIndex: 'none' },
      dataView: { readOnly: false, title: 'Data', lang: ['Data','Close','Refresh'] },
      magicType: { type: ['line','bar','stack','tiled'] },
      restore: {},
      saveAsImage: { pixelRatio: 2, name: 'chart', type: 'png' }
    }
  },
  series: [{ type: 'bar', data: [10, 20, 30] }]
});

dataZoom через toolbox

Toolbox dataZoom добавляет кнопки «приблизить/отдалить» и выбор области. Сочетайте с компонентами dataZoom: 'inside' (жесты мыши/тача) и 'slider' (перетаскиваемая полоса). yAxisIndex: 'none' ограничивает зум только осью x. Для временных рядов с тысячами точек dataZoom необходим для навигации.

echarts
chart.setOption({
  toolbox: {
    feature: {
      dataZoom: {
        yAxisIndex: 'none',    // only zoom x axis
        title: { zoom: 'Zoom In', back: 'Zoom Out' }
      }
    }
  },
  dataZoom: [
    { type: 'inside', xAxisIndex: 0 },   // mouse wheel
    { type: 'slider', xAxisIndex: 0 }    // slider below chart
  ],
  xAxis: { type: 'category', data: longData },
  series: [{ type: 'line', data: longData }]
});

Data view (редактирование данных)

dataView показывает данные, лежащие в основе графика. readOnly: false позволяет пользователю редактировать их и перерисовывать. optionToContent/contentToOption дают полный контроль над представлением (например, HTML-таблица вместо JSON). Полезно для отладки или чтобы опытные пользователи правили данные. Правки вызывают перерисовку.

echarts
chart.setOption({
  toolbox: {
    feature: {
      dataView: {
        readOnly: false,                  // editable
        title: 'View Data',
        lang: ['Data View', 'Close', 'Refresh'],
        optionToContent: function (opt) {
          // custom HTML rendering instead of JSON
          return '<div>Custom view</div>';
        },
        contentToOption: function (div) {
          // parse edited content back to option
          return opt;
        }
      }
    }
  }
});

Magic type и restore

magicType позволяет на лету переключать line/bar и стековые/плиточные раскладки — ECharts сам выполняет преобразование. restore возвращает все изменения toolbox к исходному option. Событие magicTypeChanged даёт реакцию на смену типа (например, обновить подписи). Отлично для исследования без лишнего кода.

echarts
chart.setOption({
  toolbox: {
    feature: {
      magicType: {
        type: ['line', 'bar', 'stack', 'tiled'],
        title: { line: 'Line', bar: 'Bar', stack: 'Stack', tiled: 'Tile' }
      },
      restore: { title: 'Restore' }
    }
  },
  series: [
    { type: 'bar', name: 'A', data: [10, 20, 30] },
    { type: 'bar', name: 'B', data: [15, 25, 35] }
  ]
});

chart.on('magicTypeChanged', function (params) {
  console.log('Switched to', params.currentType);
});

Сохранение в изображение

saveAsImage экспортирует график в PNG/JPG. pixelRatio: 2 удваивает разрешение для retina. excludeComponents убирает элементы (например, toolbox) из экспорта. getDataURL возвращает base64-строку для программного скачивания или загрузки. Рендерер SVG экспортирует более чистые векторные изображения при type: 'svg'.

echarts
chart.setOption({
  toolbox: {
    feature: {
      saveAsImage: {
        type: 'png',                  // 'png' or 'jpg'
        name: 'my-chart',
        pixelRatio: 2,                // higher = sharper
        backgroundColor: '#fff',
        excludeComponents: ['toolbox'],
        title: 'Download'
      }
    }
  }
});

// programmatic export
chart.getDataURL({
  type: 'png',
  pixelRatio: 2,
  backgroundColor: '#fff'
});
19

Метки (MarkPoint / MarkLine / MarkArea)

MarkPoint (выделение точек)

markPoint привлекает внимание к конкретным точкам. Встроенные типы: 'max', 'min', 'average'. Можно задать coord: [x, y] для своих точек. symbolSize масштабирует маркер. MarkPoint рисуются поверх серии и не влияют на масштаб осей. Полезно для выделения экстремумов или событий.

echarts
chart.setOption({
  series: [{
    type: 'line',
    data: [10, 50, 30, 80, 20, 90],
    markPoint: {
      symbolSize: 50,
      data: [
        { type: 'max', name: 'Peak' },
        { type: 'min', name: 'Low' },
        { type: 'average', name: 'Avg' }
      ],
      label: { fontSize: 12 }
    }
  }]
});

MarkLine (опорные линии)

markLine рисует опорные линии. type: 'average' проводит горизонтальную линию по среднему. { yAxis: 60 } рисует свою горизонтальную линию (пороги, цели). { xAxis: 'Wed' } рисует вертикальную линию (отметки событий). symbol: 'none' убирает стрелки на концах для более чистого вида.

echarts
chart.setOption({
  series: [{
    type: 'bar',
    data: [10, 50, 30, 80, 20],
    markLine: {
      symbol: 'none',              // no end arrows
      lineStyle: { type: 'dashed', color: '#ee6666' },
      data: [
        { type: 'average', name: 'Avg' },
        { yAxis: 60, name: 'Threshold' },          // horizontal line at y=60
        { xAxis: 'Wed', name: 'Event' }            // vertical line at category
      ],
      label: { formatter: '{b}: {c}' }
    }
  }]
});

MarkArea (выделение областей)

markArea закрашивает область графика. data — массив пар [начало, конец], каждая пара задаёт прямоугольник через coord (значения xAxis/yAxis). Удобно для выделения рабочих часов, выходных, кризисов или любого интересного промежутка. silent: false заставляет область реагировать на наведение.

echarts
chart.setOption({
  series: [{
    type: 'line',
    data: [10, 20, 30, 40, 50, 60, 70],
    markArea: {
      silent: false,
      itemStyle: { color: 'rgba(255, 200, 0, 0.2)' },
      data: [
        [
          { xAxis: 'Tue' },          // start
          { xAxis: 'Thu' }           // end
        ],
        [
          { xAxis: 'Fri' },
          { xAxis: 'Sat' }
        ]
      ],
      label: { show: true, position: 'top' }
    }
  }]
});

Комбинированные метки

Сочетайте markPoint, markLine и markArea на одной серии. Типичный аналитический график выделяет пик (markPoint), показывает среднее и цель (markLine) и закрашивает заметный период (markArea). У каждой метки свой стиль. Не переусердствуйте: слишком много меток засоряют график.

echarts
chart.setOption({
  series: [{
    type: 'line',
    data: [20, 50, 30, 80, 60, 90, 40],
    markPoint: {
      data: [{ type: 'max', name: 'Max' }]
    },
    markLine: {
      data: [
        { type: 'average', name: 'Average' },
        { yAxis: 70, name: 'Target', lineStyle: { color: '#91cc75' } }
      ]
    },
    markArea: {
      data: [[
        { xAxis: 'Wed' },
        { xAxis: 'Fri', itemStyle: { color: 'rgba(145,204,117,0.1)' } }
      ]]
    }
  }]
});

Метки с произвольными координатами

Для своих позиций используйте coord: [x, y] вместо встроенных типов. markLine с произвольными координатами принимает массив из двух объектов coord (начало и конец) — можно рисовать любые линии (диагонали, линии тренда по регрессии). symbol: 'pin' меняет форму markPoint. Так появляются аннотации на конкретных точках.

echarts
chart.setOption({
  series: [{
    type: 'scatter',
    data: [[10,20], [50,60], [80,90]],
    markPoint: {
      data: [
        { coord: [50, 60], name: 'Center', value: 'Origin' }
      ],
      symbol: 'pin',
      symbolSize: 40,
      itemStyle: { color: '#ee6666' }
    },
    markLine: {
      data: [
        [{ coord: [0, 0] }, { coord: [100, 100] }]  // diagonal line
      ]
    }
  }]
});
20

Анимация и взаимодействие

Опции анимации

Анимацией можно управлять глобально. animationDuration — длительность анимации появления. Названия easing включают 'linear', 'cubicOut', 'elasticOut', 'bounceOut'. animationDelay как функция разносит элементы во времени (idx * 100 заставляет каждый столбец появляться на 100 мс позже предыдущего). Для больших данных animationThreshold автоматически отключает анимацию ради производительности.

echarts
chart.setOption({
  animation: true,
  animationThreshold: 2000,        // disable above this data count
  animationDuration: 2000,         // entrance duration (ms)
  animationEasing: 'cubicOut',     // easing function
  animationDelay: function (idx) { // stagger by index
    return idx * 100;
  },
  animationDurationUpdate: 500,    // update transition
  animationEasingUpdate: 'cubicInOut',
  animationDelayUpdate: 0,
  series: [{ type: 'bar', data: [10, 20, 30, 40] }]
});

Функции easing

ECharts поддерживает 30+ функций easing. 'cubicOut' (по умолчанию) — естественное замедление. 'elasticOut' и 'bounceOut' добавляют игривое перерегулирование. 'sinusoidalInOut' плавный и нейтральный. Для визуализации данных предпочитайте мягкие easing (cubic, sinusoidal): пружинистые анимации отвлекают от данных. Согласуйте easing с характером бренда.

echarts
chart.setOption({
  animationEasing: 'elasticOut',
  // available easings:
  // linear, quadraticIn, quadraticOut, quadraticInOut,
  // cubicIn, cubicOut, cubicInOut,
  // quarticIn, quarticOut, quarticInOut,
  // quinticIn, quinticOut, quinticInOut,
  // sinusoidalIn, sinusoidalOut, sinusoidalInOut,
  // exponentialIn, exponentialOut, exponentialInOut,
  // circularIn, circularOut, circularInOut,
  // elasticIn, elasticOut, elasticInOut,
  // backIn, backOut, backInOut,
  // bounceIn, bounceOut, bounceInOut
  series: [{ type: 'bar', data: [10, 20, 30] }]
});

Анимация загрузки

showLoading показывает спиннер поверх графика, пока идут данные. Вызовите hideLoading, когда данные готовы. Это стандартный паттерн асинхронной загрузки: показать загрузку, получить данные, скрыть загрузку, setOption. Настройте цвет и текст спиннера под своё приложение. Маска блокирует взаимодействие пользователя во время загрузки.

echarts
// show loading mask
chart.showLoading({
  text: 'Loading data...',
  color: '#5470c6',
  textColor: '#333',
  maskColor: 'rgba(255, 255, 255, 0.8)',
  zlevel: 0,
  fontSize: 14,
  showSpinner: true,
  spinnerRadius: 10,
  lineWidth: 2
});

// hide after data loads
fetch('/api/data').then(r => r.json()).then(data => {
  chart.hideLoading();
  chart.setOption({ series: [{ type: 'bar', data: data }] });
});

API событий

chart.on привязывает обработчики событий. Частые события: click, dblclick, mouseover, legendselectchanged, datazoom, pieselectchanged. params содержит информацию о компоненте. dispatchAction запускает действия (highlight, showTip, dataZoom) — удобно для синхронизации внешнего интерфейса с графиком или программного показа подсказок.

echarts
chart.on('click', function (params) {
  console.log('Clicked:', params.componentType, params.seriesType);
  console.log('Series:', params.seriesName, 'Data:', params.name, params.value);
  console.log(' dataIndex:', params.dataIndex);
});

chart.on('legendselectchanged', function (params) {
  console.log('Legend toggled:', params.selected);
});

chart.on('datazoom', function (params) {
  console.log('Zoom:', params.batch?.[0]?.start, params.batch?.[0]?.end);
});

// dispatch an action programmatically
chart.dispatchAction({
  type: 'highlight',
  seriesIndex: 0,
  dataIndex: 2
});

chart.dispatchAction({ type: 'showTip', x: 100, y: 100 });

Графические элементы (свои фигуры)

graphic позволяет накладывать на график свои фигуры (текст, круги, прямоугольники, изображения) — полезно для водяных знаков, сообщений о пустом состоянии и аннотаций. Элементы поддерживают позиционирование (left/top/right/bottom в px или %), стили и события. Они рисуются выше или ниже графика в зависимости от z. Это выход, когда стандартных опций не хватает.

echarts
chart.setOption({
  graphic: {
    elements: [
      {
        type: 'text',
        left: 'center', top: 'middle',
        style: { text: 'No Data', fontSize: 24, fill: '#999' },
        invisible: false
      },
      {
        type: 'circle',
        shape: { cx: 50, cy: 50, r: 20 },
        style: { fill: '#5470c6' },
        onclick: function () { console.log('clicked'); }
      },
      {
        type: 'image',
        style: { image: 'logo.png', width: 100, height: 40 },
        left: 10, top: 10
      }
    ]
  }
});

Was this helpful?

Learning path

Learn from scratch

Learn this language from the ground up with structured lessons.