시작하기
설정 & 첫 차트
ECharts는 명시적인 width/height를 가진 DOM 요소 위에서 초기화됩니다. setOption이 차트 전체를 설정합니다. Apache ECharts(구 Baidu ECharts)는 가장 강력한 JS 차팅 라이브러리 중 하나입니다.
<!-- include ECharts -->
<script src="https://cdn.jsdelivr.net/npm/echarts@5/dist/echarts.min.js"></script>
<div id="chart" style="width: 600px; height: 400px;"></div>
<script>
const chart = echarts.init(document.getElementById('chart'));
chart.setOption({
title: { text: 'Sales' },
xAxis: { data: ['Q1', 'Q2', 'Q3', 'Q4'] },
yAxis: {},
series: [{
type: 'bar',
data: [100, 200, 150, 300]
}]
});
</script>테마 & 렌더러로 초기화
init은 (dom, theme, opts)를 받습니다. 'svg' 렌더러는 어떤 줌에서도 선명하고 단순한 차트에서 더 작은 DOM을 만들며, 'canvas'는 큰 데이터셋에서 더 빠릅니다. devicePixelRatio가 레티나에서의 선명도를 제어합니다. 차트를 제거할 때는 메모리 확보를 위해 항상 dispose()를 호출하세요.
// register a theme (defined elsewhere or imported)
echarts.registerTheme('myTheme', {
color: ['#5470c6', '#91cc75'],
backgroundColor: '#f5f5f5'
});
// renderer: 'canvas' (default, faster) or 'svg' (sharper, lighter)
const chart = echarts.init(document.getElementById('chart'), 'myTheme', {
renderer: 'svg',
devicePixelRatio: 2,
width: 800,
height: 600,
locale: 'EN'
});
// detached from DOM later
chart.dispose();반응형 리사이즈
컨테이너가 변해도 ECharts는 자동 리사이즈되지 않습니다 — chart.resize()를 직접 호출해야 합니다. ResizeObserver가 컨테이너 크기를 감시하는 현대적 방법입니다(레이아웃 기반 변화에는 window resize보다 낫습니다). SPA에서 누수를 막으려면 해체 시 항상 dispose()를 호출하세요.
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 호출을 한 번의 렌더로 묶습니다.
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하세요.
function mountChart(dom) {
// avoid double-init on the same DOM node
const existing = echarts.getInstanceByDom(dom);
if (existing) return existing;
const chart = echarts.init(dom);
chart.setOption({ /* ... */ });
return chart;
}
// in a framework cleanup (React useEffect / Vue onUnmounted):
function unmount(dom) {
const chart = echarts.getInstanceByDom(dom);
if (chart) chart.dispose(); // free memory + remove DOM
}
// dispose all charts on a page
echarts.disposeAll?.(); // not built-in; iterate manually
Array.from(document.querySelectorAll('[_echarts_instance_]'))
.forEach(dom => echarts.dispose(dom));막대 차트
기본 막대
막대 차트에는 카테고리 xAxis와 값 yAxis가 필요합니다. series.data의 각 값이 하나의 카테고리에 매핑됩니다. itemStyle이 막대 모양을 제어합니다. 세로 막대는 카테고리 축이 x이고, 가로 막대는 x와 y 축 타입을 서로 바꾸면 됩니다.
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 이름이 없는 시리즈는 여전히 그룹으로 표시됩니다.
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' 라벨은 막대 끝에 놓입니다. 가로 막대는 긴 카테고리 이름이나 많은 카테고리 비교에 더 좋습니다 — 라벨을 회전시킬 필요가 없습니다.
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는 숫자(모든 모서리)나 배열이 될 수 있습니다.
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는 가장 큰 값을 맨 위에 둡니다. 애니메이션 데이터 스토리로 인기 있습니다.
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은 그룹 사이 간격입니다. 백분율은 카테고리 밴드 기준이라 리사이즈해도 비율이 유지됩니다.
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
}]
});선 차트
기본 선
선 차트는 type: 'line'을 씁니다. 점은 기본적으로 symbol 마커로 표시되며, symbol: 'none'으로 숨길 수 있습니다. 선은 데이터 순서대로 점을 연결합니다. 시계열에는 xAxis를 type: 'time'으로 두고 [timestamp, value] 쌍을 쓰세요.
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축 가장자리에서 시작하게 합니다.
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과 일치해야 합니다.
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 시 시리즈 전체를 하이라이트합니다. 시간에 따른 구성(예: 소스별 트래픽) 표시에 유용합니다.
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'는 점 뒤에서 계단을 만듭니다. 계단 차트는 연속적이지 않고 이산적으로 변하는 값(재고 수준, 서버 상태)에 적합합니다.
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는 점을 실제 시간 간격으로 배치하므로 데이터의 공백이 올바르게 보입니다. 간격이 다양한 시계열에 맞는 선택입니다.
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
}]
});파이 차트
기본 파이
파이 차트는 축을 쓰지 않습니다 — series.data는 {value, name}의 배열입니다. radius가 컨테이너의 짧은 쪽 기준 백분율로 파이 크기를 제어합니다. emphasis 스타일은 hover에 적용됩니다. 범례는 data.name에서 자동으로 라벨을 만듭니다.
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%]은 꽉 찬 파이입니다.
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'는 값을 그대로 씁니다. 각 조각은 각도가 같고 반지름이 다릅니다. 각도만으로 판단하기 어려운 크기 비교에 좋습니다.
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는 라벨 가까운 구간입니다. 커스텀 라벨은 파이 차트 가독성을 크게 높입니다.
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° 파이가 하단에 놓이게 합니다. 부분 파이는 게이지나 스타일리시한 대시보드에 자주 쓰입니다.
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' }
]
}]
});산점도
기본 산점도
산점도는 두 값 축을 쓰며 각 데이터 점은 [x, y]입니다. symbolSize가 점 크기를 제어합니다(고정 또는 함수로 점별). 산점도는 두 변수 간 상관관계를 드러냅니다. 두 축 모두 type: 'value'(숫자)이며, 카테고리 기반 막대/선과 다릅니다.
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변수 데이터에 유용합니다.
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 컴포넌트가 슬라이더가 있는 범례를 보여줍니다.
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'이 더 눈에 띕니다. 아껴서 쓰세요 — 물결이 많으면 산만해집니다.
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만 점 이상도 부드럽게 유지됩니다.
// 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 }
}]
});레이더 차트
기본 레이더
레이더 차트에는 각 축을 정의하는 radar.indicator 배열(이름과 max)이 필요합니다. 시리즈 데이터는 지시자에 대응하는 값 배열입니다. 레이더는 소수 항목의 여러 속성 비교(선수 스탯, 제품 비교)에 좋습니다. max가 각 축의 눈금을 정합니다.
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개 항목에 머무세요.
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) 유지하세요. 심볼이 각 꼭짓점을 표시합니다.
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이 축 라벨을 스타일링합니다. 이 옵션들은 데이터를 건드리지 않고 차트의 시각 구조를 제어합니다.
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를 조정하세요.
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] }]
}]
});히트맵
직교 히트맵
직교 히트맵에는 셀을 색칠하는 visualMap이 필요합니다. 데이터는 [x, y, value]입니다. label: { show: true }는 셀에 값을 인쇄합니다(작은 격자에만 적합). calculable: true는 슬라이더 손잡이를 추가합니다. 히트맵은 밀도 패턴(예: 시간대별 활동)을 드러냅니다.
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'는 컨테이너에 맞춥니다.
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)은 범례 없이도 색을 구동합니다.
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셀 격자입니다.
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는 팬/줌을 가능하게 합니다. 단계 구분도(지역별 색칠 지도)가 이렇게 만들어집니다.
// 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 }
]
}]
});트리 차트
기본 트리 (세로)
트리 차트는 계층 데이터를 렌더링합니다. layout: 'orthogonal'과 orient: 'LR'이 왼쪽→오른쪽 트리를 만듭니다. expandAndCollapse로 사용자가 클릭해 서브트리를 접거 펼칠 수 있습니다. leaves가 리프 노드 스타일을 설정합니다. 조직도, 파일 트리, 분류 체계에 완벽합니다.
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가 곡선 커넥터를 만들어 부드러운 느낌을 줍니다.
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 시 모든 후손을 하이라이트해 브랜치 추적을 돕습니다.
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'와 결합하세요.
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가 펼침/접기를 부드럽게 합니다.
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);
}
});선버스트 차트
기본 선버스트
선버스트는 각 링이 계층 수준을 나타내는 방사형 트리입니다. 안쪽 = 부모, 바깥쪽 = 자식. 각 노드의 값이 각도 크기를 결정합니다. radius: [0, '90%']는 꽉 찬 원판, [inner, outer]는 링 선버스트를 만듭니다. 계층적 비율 시각화에 좋습니다.
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)이 각 깊이에서 텍스트를 읽기 쉽게 유지합니다. 세밀한 스타일 제어를 제공합니다.
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가 조각을 시각적으로 분리합니다. 선버스트는 인터랙티브입니다: 클릭은 보통 드릴다운입니다. 깊은 트리에서 맥락 유지에 조상 하이라이트를 쓰세요.
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도보다 작은 조각의 라벨을 숨겨 어수선함을 피합니다. 부모 노드의 값은 생략 시 자식들의 합으로 자동 계산됩니다.
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를 만들 수 있습니다. 클릭된 노드로 데이터를 교체해 줌인하세요. '뒤로' 버튼을 원하면 부모에 대한 참조를 유지하세요. 선버스트 드릴다운은 화면을 압도하지 않고 깊은 계층을 탐 색하는 데 탁월합니다.
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 });
}
});생키 다이어그램
기본 생키
생키는 노드 간 흐름을 보여줍니다. data는 노드(name 포함)이고, links는 흐름(source, target, value)입니다. 각 링크의 너비가 값에 비례합니다. emphasis.focus: 'adjacency'는 hover 시 연결된 노드를 하이라이트합니다. 에너지, 금전, 사용자 흐름 시각화에 좋습니다.
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를 명시하면 자동 배치를 무시하고 열 배치를 강제합니다.
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'는 라벨을 노드 옆에 둡니다 — 왼쪽→오른쪽 흐름에서 흔합니다.
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')로 나눠 흐름을 비순환으로 만드는 것입니다. 이는 피드백 루프를 시각적으로 표현합니다. 흐름 보존을 항상 검증하세요: 노드의 입력 총합은 출력 총합과 같아야 합니다.
// 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된 노드를 통과하는 전체 경로를 하이라이트해 인과 사슬을 드러냅니다.
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);
}
});퍼널 차트
기본 퍼널
퍼널은 단계마다 항목이 줄어드는 과정을 보여줍니다. sort: 'descending'(기본값)은 가장 큰 단계를 맨 위에 둡니다. 데이터는 과정 흐름 순서대로 정렬하세요. 퍼널은 영업 파이프라인, 전환 분석, 온보딩 단계에 완벽합니다.
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가 조각 너비를 백분율로 제한해 작은 단계도 보이게 합니다.
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 시 라벨을 키웁니다.
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를 설정할 수도 있습니다. 세련된 느낌을 위해 순차 색상 팔레트(초기 단계는 밝게, 전환은 어둡게)를 써 퍼널 은유를 강화하세요.
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 테스트 시각화나 연도별 전환 비교에 좋습니다. 시리즈를 구분하려면 대비되는 색을 쓰세요.
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' }
}
]
});게이지 차트
기본 게이지
게이지는 호 위에 단일 값을 보여줍니다. min/max가 눈금을 정합니다. progress는 값까지 색칠된 호를 보여주고(axisLine이 트랙), detail이 가운데에 값 텍스트를 렌더링합니다. valueAnimation이 숫자를 부드럽게 전환합니다. KPI와 단일 지표 대시보드에 좋습니다.
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을 조합하면 실제 계기를 흉내 냅니다. 아날로그 느낌을 원할 때 유용합니다.
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 호가 이 구역 안에서 현재 값을 가리킵니다.
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) 유지하세요 — 많으면 게이지가 어수선해집니다. 이름이 포인터 옆 라벨로 나타납니다.
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은 진행 끝을 둥글게 합니다. 이 스타일은 현대 대시보드에서 인기입니다 — 링으로 위장한 게이지입니다.
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 }]
}]
});좌표계
다중 X축
xAxis는 배열입니다 — 각 항목이 별개의 축입니다. 시리즈는 xAxisIndex(0 기반)로 축에 바인딩합니다. 이로써 하나의 차트가 스케일이나 단위가 다른 두 지표를 보여줍니다. position으로 축을 위/아래에 놓으세요. 주식 차트(가격 + 거래량)나 날씨(기온 + 습도)에 흔합니다.
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개 이상은 혼란스러우니 피하세요.
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°를 맨 위(북)에 둡니다. 극좌표는 방향 데이터(풍향 도표), 주기적 패턴, 로즈/나이팅게일 변형에 좋습니다.
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이 라벨을 지역화합니다. 기여 그래프에는 히트맵과 결합하세요.
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
}]
});평행좌표
평행좌표는 차원마다 하나의 축으로 다차원 데이 터를 그립니다. 각 데이터 행이 모든 축을 가로지르는 폴리라인이 됩니다. 고차원 데이터의 상관관계와 클러스터를 드러냅니다(예: 가격, 연비, 연식, 안전성으로 차량 비교). 데이터 탐색에 유용합니다.
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 시리즈와 짝지어야 값으로 지역을 색칠합니다(단계 구분도).
// 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' }
}
}
});
});데이터셋
기본 데이터셋
Dataset은 데이터를 시리즈 설정과 분리합니다. source는 2차원 배열입니다(첫 행이 헤더). seriesLayoutBy: 'column'은 각 시리즈가 한 열을 취하게 합니다. encode가 데이터셋 열을 x/y 에 매핑합니다. 이는 데이터를 표현에서 분리합니다 — 여러 차트가 데이터를 공유할 때 유용합니다.
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는 인덱스 대신 차원 이름을 써 읽기 쉽습니다. 객체 행은 손으로 쓰기 쉽고 자기 문서화가 됩니다.
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을 통한 커스텀.
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 경유)을 씁니다. 인코딩으로 같은 데이터셋이 여러 차트 타입에서 재사용됩니다.
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만 바꾸면 됩니다.
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' }
}]
});VisualMap
연속 VisualMap
연속 visualMap은 숫자 범위를 색(및 선택적으로 크기)에 매핑합니다. inRange.color가 그라디언트입니다(보간됨). calculable: true는 필터링용 드래그 손잡이를 추가합니다. orient와 left/top이 위치를 정합니다. visualMap이 시리즈 색을 구동합니다 — itemStyle.color를 수동으로 설정하지 않습니다.
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)을 정의합니다. 범주형 버킷(예: 낮음/중간/높음 위험)을 원할 때는 그라디언트보다 명확합니다. 단계 구분도와 범주형 산점도에 유용합니다.
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). 색으로 구분하고 싶은 범주 속성(예: 우선순위, 상태)이 있을 때 좋습니다.
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이 단순 범례가 아니라 인터랙티브 필터가 됩니다.
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을 가질 수도 있습니다.
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
});범례
기본 범례
범례는 시리즈 이름을 나열해 표시 여부를 토글하게 합니다. data는 series.name과 일치해야 합니다(또는 자동 파생). icon이 마커를 스타일링합니다. 범례 항목을 클릭하면 그 시리즈가 토글됩니다. setOption으로 시리즈가 추가/제거되면 범례가 자동 갱신됩니다.
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이 범례 항목 사이 간격을 제어합니다. 은은한 배경/테두리가 범례를 차트와 시각적으로 분리합니다. 위치가 중요합니다 — 하단 범례는 세로 공간을 아껴 줍니다.
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'입니다.
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개 이상 시리즈 차트에서 넘침을 막는 필수 기능입니다. 페이지 아이콘/텍스트 스타일이 내비게이션을 커스터마이징합니다. 세로 스크롤 범례는 오른쪽 여백에 잘 맞습니다.
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}'처럼 섞인 스타일의 범례가 가능합니다.
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
});툴팁
기본 툴팁
trigger: 'item'은 데이터 점별 툴팁(산점도, 파이)을, 'axis'는 카테고리 전체 툴팁(막대, 선)을 보여줍니다. axisPointer가 가이드 선을 그립니다 — 'shadow'는 반투명 밴드(막대에 좋음), 'line'은 얇은 선(선 차트에 좋음), 'cross'는 x/y 선을 모두 보여줍니다.
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는 배열입니다 — 순회하세요.
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이 가이드 선을 커스터마이징합니다. 쌓인 차트 간 데이터 비교에는 동기화된 포인터가 필수입니다.
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 툴팁은 점별로 정확합니다.
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로 스타일을 완전히 제어합니다.
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] }
]
});툴박스
툴박스 기능
툴박스는 액션 아이콘을 추가합니다(기본 오른쪽 위). dataZoom은 드래그 선택으로 줌합니다. dataView는 원본 데이터를 보여줍니다(readOnly: false면 편집 가능). magicType은 차트 타입을 바꿉니다(line/bar). restore는 초기화합니다. saveAsImage는 PNG/SVG를 내보냅니다. 각 기능에는 자체 설정이 있습니다.
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이 필수입니다.
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 테이블). 디버깅이나 고급 사용자의 데이터 조정에 유용합니다. 편집은 재렌더링을 트리거합니다.
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 이벤트로 타입 전환에 반응할 수 있습니다(예: 라벨 업데이트). 추가 코드 없이 탐색할 수 있게 해 줍니다.
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 렌더러가 더 깨끗한 벡터 이미지를 내보냅니다.
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'
});마크 (MarkPoint / MarkLine / MarkArea)
MarkPoint (점 강조)
markPoint는 특정 점에 주목하게 합니다. 내장 타입: 'max', 'min', 'average'. 커스텀 점에는 coord: [x, y]를 지정할 수도 있습니다. symbolSize가 마커 크기를 조절합니다. MarkPoint는 시리즈 위에 떠 있습니다 — 축 스케일에 영향을 주지 않습니다. 극값이나 이벤트 표시에 유용합니다.
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'은 끝 화살표를 제거해 더 깔끔하게 만듭니다.
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 이벤트에 반응합니다.
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)을 표시합니다. 각 마크는 독립적인 스타일을 가집니다. 과하지 마세요 — 마크가 많으면 차트가 어수선해집니다.
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 모양을 바꿉니다. 특정 데이터 점에 주석을 달 수 있습니다.
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
]
}
}]
});애니메이션 & 인터랙션
애니메이션 옵션
애니메이션을 전역 제어합니다. animationDuration이 등장 애니메이션 길이입니다. 이징 이름: 'linear','cubicOut','elasticOut','bounceOut' 등. 함수형 animationDelay는 항목을 계단식으로 지연시킵니다(idx * 100이면 각 막대가 이전보다 100ms 늦게 나타남). 대용량 데이터셋에는 animationThreshold가 성능을 위해 애니메이션을 자동 끕니다.
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)을 권합니다 — 통통 튀는 애니메이션은 데이터에서 주의를 뺏습니다. 브랜드 성격에 맞추세요.
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. 스피너 색과 메시지를 앱에 맞게 커스터마이징하세요. 마스크가 로딩 중 사용자 조작을 막습니다.
// 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를 차트와 동기화하거나 프로그래밍 방식으로 툴팁을 보여줄 때 유용합니다.
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에 따라 차트 위나 아래에 렌더링됩니다. 표준 옵션으로 부족할 때의 탈출구입니다.
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
}
]
}
});관련 ECharts 스니펫
Copy-paste ready code for common tasks.
Bar Chart
Category bar chart with axis tooltip and styled bars.
Line Chart
Smooth multi-series line chart with area fill.
Pie Chart
Donut-style pie with emphasis effect and percentage labels.
Scatter Plot
Scatter plot with point size encoded by a third dimension.
Radar Chart
Radar with multiple indicators and overlaid value series.
Options & Series
Dataset-driven multi-series chart with grid and legend config.
Tooltip
Custom HTML tooltip with crosshair axis pointer.
Responsive
Resize chart on window and container changes, with cleanup.
Was this helpful?