Skip to content

ECharts 치트시트

Apache의 강력한 차팅·시각화 라이브러리입니다.

01

시작하기

설정 & 첫 차트

ECharts는 명시적인 width/height를 가진 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가 레티나에서의 선명도를 제어합니다. 차트를 제거할 때는 메모리 확보를 위해 항상 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는 옵션 전체를 교체합니다(시리즈 수가 바뀔 때 유용). 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

이미 차트가 있는 DOM에 init을 호출하면 오류가 납니다. 확인에는 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] }
  ]
});

가로 막대

가로 막대는 카테고리 축을 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는 각 막대 뒤에 트랙을 그립니다(진행바 스타일). 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
    }
  }]
});

막대 레이스 (동적)

막대 레이스는 순위 재정렬을 애니메이션합니다. 데이터 배열을 정렬한 뒤 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 마커로 표시되며, symbol: 'none'으로 숨길 수 있습니다. 선은 데이터 순서대로 점을 연결합니다. 시계열에는 xAxis를 type: 'time'으로 두고 [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'를 받습니다. 각 시리즈는 자신의 스타일을 가질 수 있습니다. 범례의 name은 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' }
    }
  ]
});

누적 영역

누적 영역 차트는 같은 stack 이름과 areaStyle을 가진 type: 'line'을 씁니다. 각 시리즈는 앞 시리즈 위에 쌓입니다. emphasis.focus: 'series'는 hover 시 시리즈 전체를 하이라이트합니다. 시간에 따른 구성(예: 소스별 트래픽) 표시에 유용합니다.

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 스타일은 hover에 적용됩니다. 범례는 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가 점 크기를 제어합니다(고정 또는 함수로 점별). 산점도는 두 변수 간 상관관계를 드러냅니다. 두 축 모두 type: 'value'(숫자)이며, 카테고리 기반 막대/선과 다릅니다.

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' }
  }]
});

버블 차트 (크기 = 값)

버블 차트는 점 크기가 세 번째 차원을 인코딩하는 산점도입니다. 점마다 [x, y, size]를 전달하고 symbolSize를 크기를 반환하는 함수로 설정하세요. 함수는 점마다 실행되므로 각 버블이 독립적으로 스케일됩니다. 3D 차트 없이 3변수 데이터에 유용합니다.

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
    }
  }]
});

VisualMap 산점도 (색 = 값)

visualMap은 데이터 차원을 색으로 매핑합니다. dimension: 2는 각 점의 세 번째 요소(인덱스 2)로 색을 정합니다. inRange.color가 그라디언트를 정의합니다. 이로써 산점도에 네 번째 차원(색)이 더해집니다. 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
  }]
});

이펙트 산점도 (애니메이션)

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
    }
  }]
});

대용량 산점도

수천 점에는 프로그레시브 렌더링을 활성화하세요 — ECharts가 데이터를 청크로 나눠 프레임에 걸쳐 렌더링해 멈춤을 피합니다. large: true는 최적화된 단일 드로우 콜을 씁니다. 과밀(overplotting)에는 작은 symbolSize와 불투명도를 결합하세요. 5만 점 이상도 부드럽게 유지됩니다.

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' }]
  }]
});

다중 시리즈 레이더

여러 데이터 항목은 겹치는 다각형으로 렌더링되어 비교에 이상적입니다. 각 항목은 범례와 일치하는 고유 name이 필요합니다. 시리즈가 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의 opacity를 낮게(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 }
  }]
});

캘린더 히트맵

캘린더 히트맵은 1년간의 일별 값을 보여줍니다(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 스타일은 hover에 적용됩니다. 숨겨진 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 }
    }
  }]
});

펀치카드 히트맵

펀치카드는 요일×시간의 7x24 히트맵으로 활동을 보여줍니다. 각 셀이 하나의 시간 슬롯입니다. 둥근 itemStyle이 점처럼 보이게 합니다. 펀치카드는 주간 패턴(예: 서버가 가장 바쁜 시간)을 드러냅니다. 데이터는 완전한 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'은 가로 트리(왼쪽 루트, 오른쪽 리프)를 만듭니다. 내부 노드 라벨은 노드의 왼쪽에, 리프 라벨은 오른쪽에 놓입니다 — 이는 브랜치와의 겹침을 막습니다. lineStyle의 curveness가 곡선 커넥터를 만들어 부드러운 느낌을 줍니다.

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'는 hover 시 모든 후손을 하이라이트해 브랜치 추적을 돕습니다.

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 이벤트로 노드 선택에 반응할 수 있습니다 — 드릴다운 UI에 유용합니다. 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

선버스트 차트

기본 선버스트

선버스트는 각 링이 계층 수준을 나타내는 방사형 트리입니다. 안쪽 = 부모, 바깥쪽 = 자식. 각 노드의 값이 각도 크기를 결정합니다. radius: [0, '90%']는 꽉 찬 원판, [inner, outer]는 링 선버스트를 만듭니다. 계층적 비율 시각화에 좋습니다.

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' }
  }]
});

levels 선버스트

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 }
      }
    ]
  }]
});

선버스트 아이템 스타일 & 하이라이트

emphasis.focus: 'ancestor'는 hover된 노드부터 루트까지의 경로를 하이라이트합니다 — 조각이 계층에서 어디에 속하는지 보여줍니다. borderWidth가 조각을 시각적으로 분리합니다. 선버스트는 인터랙티브입니다: 클릭은 보통 드릴다운입니다. 깊은 트리에서 맥락 유지에 조상 하이라이트를 쓰세요.

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

값 & 정렬 선버스트

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
  }]
});

선버스트 드릴다운

커스텀 click 핸들러로 자신만의 드릴다운 UX를 만들 수 있습니다. 클릭된 노드로 데이터를 교체해 줌인하세요. '뒤로' 버튼을 원하면 부모에 대한 참조를 유지하세요. 선버스트 드릴다운은 화면을 압도하지 않고 깊은 계층을 탐색하는 데 탁월합니다.

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

생키 다이어그램

기본 생키

생키는 노드 간 흐름을 보여줍니다. data는 노드(name 포함)이고, links는 흐름(source, target, value)입니다. 각 링크의 너비가 값에 비례합니다. emphasis.focus: 'adjacency'는 hover 시 연결된 노드를 하이라이트합니다. 에너지, 금전, 사용자 흐름 시각화에 좋습니다.

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 }
  }]
});

생키 노드 수준

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'
  }]
});

생키 노드 스타일 & 간격

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 }
  }]
});

순환이 있는 생키 (배수)

진짜 순환은 ECharts 생키가 실패하게 만듭니다. 우회법은 재순환 노드를 별개의 'in'과 'out' 노드(예: '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' }
  }]
});

생키 인터랙션

생키 click 이벤트는 dataType으로 노드와 간선을 구분합니다. 이를 활용해 흐름 세부를 보여주는 상세 패널을 만드세요. label.formatter: '{b}: {c}'는 이름과 값을 보여줍니다. adjacency 포커스는 hover된 노드를 통과하는 전체 경로를 하이라이트해 인과 사슬을 드러냅니다.

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'(기본값)은 가장 큰 단계를 맨 위에 둡니다. 데이터는 과정 흐름 순서대로 정렬하세요. 퍼널은 영업 파이프라인, 전환 분석, 온보딩 단계에 완벽합니다.

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가 hover 시 라벨을 키웁니다.

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가 조각을 시각적으로 분리합니다. 개별 데이터 항목에 color를 설정할 수도 있습니다. 세련된 느낌을 위해 순차 색상 팔레트(초기 단계는 밝게, 전환은 어둡게)를 써 퍼널 은유를 강화하세요.

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

게이지 차트

기본 게이지

게이지는 호 위에 단일 값을 보여줍니다. 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' }]
  }]
});

포인터 게이지

pointer 스타일이 클래식한 게이지 모양입니다. anchor는 가운데 핀입니다. 음수 distance는 눈금/라벨을 안쪽(중심쪽)으로 밉니다. radius가 게이지 전체를 스케일합니다. pointer와 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)입니다. 게이지에서 '안전/경고/위험' 범위를 보여주는 표준 방법입니다. pointer나 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 }]
  }]
});

다중 포인터 게이지

여러 데이터 항목이 같은 게이지 위에 여러 포인터를 만듭니다. 관련 지표 비교(CPU vs 메모리 vs 디스크)에 유용합니다. 각 값은 독립적으로 애니메이션됩니다. 개수는 적게(최대 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 링처럼)이 만들어집니다. pointer/눈금/라벨을 숨기면 깔끔한 미니멀 룩이 됩니다. 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(0 기반)로 축에 바인딩합니다. 이로써 하나의 차트가 스케일이나 단위가 다른 두 지표를 보여줍니다. 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축(왼쪽/오른쪽)은 단위가 다른 시리즈(예: 매출($) vs 판매량)를 그리게 합니다. 각 시리즈는 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'
  }]
});

캘린더 좌표

캘린더 좌표계는 날짜를 셀에 매핑합니다. coordinateSystem: 'calendar'인 시리즈가 이에 바인딩됩니다. cellSize는 픽셀 또는 'auto'입니다. orient: 'horizontal'이 표준적인 주간 행 레이아웃입니다. dayLabel/monthLabel의 nameMap이 라벨을 지역화합니다. 기여 그래프에는 히트맵과 결합하세요.

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 스타일은 hover에 적용됩니다. 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은 데이터를 시리즈 설정과 분리합니다. source는 2차원 배열입니다(첫 행이 헤더). seriesLayoutBy: 'column'은 각 시리즈가 한 열을 취하게 합니다. encode가 데이터셋 열을 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' } }
  ]
});

데이터셋 변환 (필터/정렬)

변환은 데이터셋을 체이닝합니다: filter는 행을 제거하고, sort는 정렬합니다. 각 변환은 fromDatasetId에서 읽고 새 데이터셋을 노출합니다. 시리즈는 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 & dimensions

encode는 데이터셋 열(인덱스 또는 이름)을 차트 차원에 매핑합니다. encode.tooltip은 툴팁에 보여줄 열을 나열합니다. 여기서는 위치에 열 0/1, 크기에 2, 색에 3(itemStyle 경유)을 씁니다. 인코딩으로 같은 데이터셋이 여러 차트 타입에서 재사용됩니다.

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]; }
  }]
});

파이 데이터셋

파이 차트는 encode를 통한 itemName과 value 매핑이 필요합니다. 같은 데이터셋이 막대 차트(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)을 정의합니다. 범주형 버킷(예: 낮음/중간/높음 위험)을 원할 때는 그라디언트보다 명확합니다. 단계 구분도와 범주형 산점도에 유용합니다.

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가 범례 라벨을 커스터마이징합니다(예: 대문자, 개수 추가). 리치 텍스트는 라벨의 일부를 다르게 스타일링하게 합니다 — 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

툴팁

기본 툴팁

trigger: 'item'은 데이터 점별 툴팁(산점도, 파이)을, 'axis'는 카테고리 전체 툴팁(막대, 선)을 보여줍니다. 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가 툴팁 내용을 커스터마이징합니다. 함수는 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
  }
});

십자선 & 축 포인터

최상위 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' }
    }
  }
});

item 트리거 툴팁

trigger: 'item'은 단일 데이터 점(파이 조각, 산점 점)에 hover할 때 툴팁을 보여줍니다. 파이, 산점도, 레이더의 기본값입니다. extraCssText는 커스텀 스타일을 위한 임의 CSS(그림자, 둥근 모서리)를 추가합니다. 파이 차트에서는 percent를 쓸 수 있습니다. item 툴팁은 점별로 정확합니다.

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' }]
  }]
});

리치 콘텐츠 툴팁

다중 시리즈 축 툴팁에서 params는 배열입니다. 순회하며 색 마커, 값, 포맷을 갖춘 풍부한 HTML 테이블을 만드세요. 정렬, 합계, 단위가 있는 프로페셔널한 툴팁은 이렇게 만듭니다. HTML을 반환하면 인라인 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

툴박스

툴박스 기능

툴박스는 액션 아이콘을 추가합니다(기본 오른쪽 위). 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은 드래그 선택용 '줌 인/아웃' 버튼을 추가합니다. 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 }]
});

데이터 뷰 (원본 편집)

dataView는 차트의 원본 데이터를 보여줍니다. readOnly: false는 사용자가 편집하고 다시 렌더링하게 합니다. optionToContent/contentToOption으로 뷰를 완전히 커스터마이징할 수 있습니다(예: JSON 대신 HTML 테이블). 디버깅이나 고급 사용자의 데이터 조정에 유용합니다. 편집은 재렌더링을 트리거합니다.

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;
        }
      }
    }
  }
});

매직 타입 & 복원

magicType은 런타임에 line/bar와 누적/타일 레이아웃 사이를 전환하게 합니다 — ECharts가 변환을 처리합니다. restore는 모든 툴박스 변경을 원래 옵션으로 되돌립니다. 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는 레티나용 해상도를 두 배로 합니다. excludeComponents는 툴박스 같은 요소를 내보내기에서 제외합니다. getDataURL은 프로그래밍 방식 다운로드/업로드용 base64 문자열을 반환합니다. type이 'svg'일 때 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는 [start, end] 쌍의 배열입니다 — 각 쌍이 coord(xAxis/yAxis 값)로 사각형을 정의합니다. 영업 시간, 주말, 불황, 관심 구간을 하이라이트할 때 유용합니다. silent: false로 하면 hover 이벤트에 반응합니다.

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이 등장 애니메이션 길이입니다. 이징 이름: 'linear','cubicOut','elasticOut','bounceOut' 등. 함수형 animationDelay는 항목을 계단식으로 지연시킵니다(idx * 100이면 각 막대가 이전보다 100ms 늦게 나타남). 대용량 데이터셋에는 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] }]
});

이징 함수

ECharts는 30개 이상의 이징 함수를 지원합니다. 'cubicOut'(기본값)은 자연스러운 감속입니다. 'elasticOut'과 'bounceOut'은 장난스러운 오버슈트를 더합니다. 'sinusoidalInOut'은 부드럽고 중립적입니다. 데이터 시각화에는 은은한 이징(cubic, sinusoidal)을 권합니다 — 통통 튀는 애니메이션은 데이터에서 주의를 뺏습니다. 브랜드 성격에 맞추세요.

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)을 트리거합니다 — 외부 UI를 차트와 동기화하거나 프로그래밍 방식으로 툴팁을 보여줄 때 유용합니다.

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.