Apache ECharts
고수준 코드High-level code선언형 option 객체로 대화형 차트를 만드는 Apache Software Foundation의 오픈소스 JavaScript 차트 라이브러리입니다.An open-source JavaScript charting library from the Apache Software Foundation that builds interactive charts from a declarative option object.
현재 버전Current version: 6.1.0, 정보 확인일 2026-10-24facts checked 2026-10-24
개요Overview
Apache ECharts는 Apache Software Foundation의 최상위 프로젝트로 관리되는 오픈소스 JavaScript 차트 라이브러리입니다. 차트를 코드로 한 단계씩 그리지 않고, 축, 데이터, 시리즈를 적은 하나의 option 객체를 넘기면 라이브러리가 그려 줍니다. 같은 option 문법으로 막대, 선, 파이부터 샌키, 트리맵, 캘린더 히트맵, 지도까지 만듭니다.
Apache ECharts is an open-source JavaScript charting library managed as a top-level project of the Apache Software Foundation. You do not draw a chart step by step in code. You pass a single option object that lists the axes, data and series, and the library draws it. The same option syntax makes everything from bar, line and pie charts to Sankey diagrams, treemaps, calendar heatmaps and maps.
툴팁, 범례, 확대 슬라이더(dataZoom), 데이터 하이라이트 같은 상호작용이 기본으로 들어 있어서 별도 코드 없이 대화형 차트가 됩니다. Canvas와 SVG 렌더러를 모두 지원하고, 대용량 데이터를 브라우저에서 다루는 기능이 강합니다. 중국어권 커뮤니티가 크고 한국어를 포함한 다국어 자료가 많은 편입니다.
Interactions such as tooltips, legends, a zoom slider (dataZoom) and data highlighting are built in, so a chart is interactive without extra code. It supports both Canvas and SVG renderers and is strong at handling large data in the browser. It has a large Chinese-speaking community and a good amount of documentation and tutorials in several languages.
2026년 10월 현재 최신 버전은 6.1.0(2026년 5월 19일)입니다. 6.0.0이 2025년 7월 30일에 나오면서 새 기본 테마와 여러 새 기능이 들어왔습니다. D3처럼 요소를 하나씩 조립하는 대신 설정으로 차트를 정의하므로, 표준 차트를 빠르게 만들고 싶은 개발자와 학습자에게 적합합니다.
As of October 2026 the latest version is 6.1.0 (May 19, 2026). Version 6.0.0 arrived on July 30, 2025 with a new default theme and several new features. Instead of assembling elements one by one like D3, you define a chart through configuration, which suits developers and learners who want standard charts quickly.
2026년 현재What's new in 2026
- ECharts 6.0.0(2025년 7월 30일): 새 테마, 코드(chord) 시리즈, 행렬(matrix) 좌표계, 재사용 가능한 custom series, 새 직교 좌표 레이아웃 방식이 추가되었습니다.
- ECharts 6.0.0 (July 30, 2025): added a new theme, a chord series, a matrix coordinate system, reusable custom series and a new cartesian layout mechanism.
- ECharts 6.1.0(2026년 5월 19일): 축 범위 계산에 dataMin과 dataMax를 쓰는 nice-extent 지원, containShape와 clip을 쓴 축 넘침 처리, 로그 축 개선이 들어왔습니다.
- ECharts 6.1.0 (May 19, 2026): added nice-extent support using dataMin and dataMax, axis overflow handling with containShape and clip, and log-axis improvements.
- 6.0으로 올릴 때는 기본 테마가 바뀌어 같은 option도 색과 모양이 달라질 수 있으니, 기존 차트는 업그레이드 후 눈으로 확인하십시오.
- When moving to 6.0, the default theme changed, so the same option can look different in color and shape; check existing charts by eye after upgrading.
- 검증된 AI 기능은 라이브러리에 포함되어 있지 않습니다. AI 어시스턴트는 option 객체를 잘 생성하는 편이라, 요청해서 받은 option을 직접 실행해 값과 축을 확인하는 방식이 실용적입니다.
- No verified AI feature is included in the library. AI assistants generally produce option objects well, so a practical workflow is to request one, run it yourself and check the values and axes.
강점Strengths
- 하나의 option 문법으로 20가지가 넘는 차트 유형을 만듭니다. 새 차트 유형을 배워도 문법이 크게 바뀌지 않습니다.
- One option syntax produces more than twenty chart types, so learning a new chart type does not change the syntax much.
- 툴팁, 범례, 줌, 브러시, 데이터 하이라이트 같은 상호작용이 기본 제공됩니다.
- Tooltips, legends, zoom, brush and data highlighting are built in.
- dataset 기능으로 데이터와 시각 인코딩을 분리하고, 같은 데이터를 여러 차트에서 공유할 수 있습니다.
- The dataset feature separates data from visual encoding, and several charts can share the same data.
- Canvas와 SVG 렌더러를 선택할 수 있고, 큰 데이터를 다루는 최적화가 되어 있습니다.
- You can choose between Canvas and SVG renderers, and it has optimizations for large data.
- 지도, 캘린더, 샌키, 트리맵, 선버스트, 평행 좌표 등 비즈니스 대시보드에 필요한 유형이 풍부합니다.
- It covers many types needed for business dashboards, such as maps, calendars, Sankey, treemaps, sunbursts and parallel coordinates.
- Apache-2.0 라이선스로 상업적 용도에도 쓸 수 있고, 필요한 모듈만 가져오는 트리 셰이킹도 지원합니다.
- The Apache-2.0 license allows commercial use, and tree shaking lets you import only the modules you need.
한계Limitations
- option 객체가 커지면 읽기 어렵습니다. 중첩된 옵션 이름을 익히는 데 시간이 걸립니다.
- Option objects become hard to read as they grow, and learning the nested option names takes time.
- 정해진 차트 유형을 벗어나는 완전히 새로운 시각화는 D3처럼 만들기 어렵습니다. custom series로 확장할 수 있지만 수고가 듭니다.
- Entirely new visualizations outside the built-in types are harder to make than with D3. Custom series can extend it, but it takes effort.
- 기본 디자인이 일반 대시보드 느낌이라 편집용 그래픽에는 따로 다듬어야 합니다.
- The default design looks like a generic dashboard, so editorial graphics need extra styling.
- 번들 크기가 커질 수 있어서 필요한 모듈만 불러오는 설정이 필요합니다.
- The bundle can grow large, so you should configure it to import only the modules you need.
- Canvas 렌더링이 기본이라 스크린 리더 접근성이 제한됩니다. 라이브러리에는 접근성 보조 옵션이 있지만 표나 요약 글 같은 대안을 함께 제공하는 것이 좋습니다.
- Canvas rendering is the default and limits screen-reader access. The library has accessibility options, but you should also provide alternatives such as a table or summary text.
- 3D 차트와 일부 지도 기능은 별도 확장 패키지가 필요합니다.
- 3D charts and some map features need separate extension packages.
이런 용도에 최적Best For
필터와 툴팁이 있는 대화형 대시보드를 JavaScript로 빠르게 만들 때 맞습니다. 사내 지표 화면, 금융 시계열 차트, 여러 차트 유형이 한 화면에 모이는 관리자 페이지, 데이터가 수만 점인 브라우저 차트에 적합합니다.
It fits when you need to build interactive dashboards with filters and tooltips quickly in JavaScript. Typical uses are internal metric screens, financial time-series charts, admin pages that combine many chart types on one screen, and browser charts with tens of thousands of points.
데이터 분석 중 빠른 탐색은 Python의 seaborn이나 Plotly가 더 가깝고, 독창적인 편집용 그래픽은 D3가 더 자유롭습니다. 노코드로 게시용 차트를 만들려면 Datawrapper나 Flourish를 쓰십시오.
For quick exploration during data analysis, seaborn or Plotly in Python is closer, and for original editorial graphics D3 is freer. For no-code publishable charts, use Datawrapper or Flourish.
시작하기Getting Started
- HTML에서 CDN으로 불러오거나(
<script>)npm install echarts로 설치합니다. 번들러에서는import * as echarts from "echarts"로 가져옵니다. - Load it from a CDN with a
<script>tag in HTML, or install withnpm install echarts. With a bundler, import it asimport * as echarts from "echarts". - 너비와 높이가 지정된
div를 만듭니다. 크기가 0이면 차트가 보이지 않습니다. - Add a
divwith an explicit width and height. If the size is 0, the chart is not visible. echarts.init으로 차트를 만들고setOption에 option 객체를 넘깁니다.- Create the chart with
echarts.initand pass the option object tosetOption. - 창 크기가 바뀔 수 있는 페이지에서는
chart.resize()를 호출합니다. - On pages where the window size can change, call
chart.resize().
<div id="chart" style="width: 640px; height: 400px"></div>
<script src="https://cdn.jsdelivr.net/npm/echarts@6.1.0/dist/echarts.min.js"></script>
<script>
const chart = echarts.init(document.getElementById("chart"));
chart.setOption({
title: { text: "Quarterly sales (million KRW)" },
tooltip: { trigger: "axis" },
legend: {},
dataset: {
source: [
["quarter", "2025", "2026"],
["Q1", 120, 150],
["Q2", 132, 161],
["Q3", 101, 174],
["Q4", 134, 182]
]
},
xAxis: { type: "category" },
yAxis: { type: "value", min: 0 },
series: [{ type: "bar" }, { type: "bar" }]
});
window.addEventListener("resize", () => chart.resize());
</script>
AI 어시스턴트에게 option 객체를 부탁하는 프롬프트 예시입니다.
Here is an example prompt for asking an AI assistant for an option object.
ECharts 6.1 option 객체를 만들어 줘. 월별 매출 선 차트이고, 툴팁과 dataZoom 슬라이더를 넣고, y축은 0에서 시작하게 해 줘. 데이터는 dataset으로 분리해서 내가 값만 바꿔 넣을 수 있게 해 줘.
Write an ECharts 6.1 option object for a monthly revenue line chart with a tooltip and a dataZoom slider. Make the y axis start at 0, and keep the data in a dataset so I can swap in my own values.
지원 차트 유형Supported Chart Types
기본 시리즈로 막대(bar), 선(line), 파이(pie), 산점도(scatter), 효과 산점도(effectScatter), 레이더(radar), 박스플롯(boxplot), 캔들스틱(candlestick), 히트맵(heatmap), 퍼널(funnel), 게이지(gauge), 평행 좌표(parallel)를 지원합니다.
Its basic series include bar, line, pie, scatter, effectScatter, radar, boxplot, candlestick, heatmap, funnel, gauge and parallel.
구조와 흐름을 보여 주는 트리(tree), 트리맵(treemap), 선버스트(sunburst), 샌키(sankey), 그래프(graph, 포스 레이아웃 포함), 테마리버(themeRiver), 6.0에서 추가된 코드(chord)도 있습니다. 지도(map), 캘린더 좌표계 히트맵, 픽토그램 막대(pictorialBar), 사용자 정의 시리즈(custom)로 범위를 더 넓힐 수 있습니다.
It also has tree, treemap, sunburst, sankey, graph (including force layout) and themeRiver series for structure and flow, plus the chord series added in 6.0. Maps, calendar-coordinate heatmaps, pictorialBar and custom series widen the range further.