SpreadJS 블로그 MESCIUS 기술 블로그 ·

SpreadJS로 웹 앱에 차트 넣는 방법: 50종 타입부터 스파크라인까지

SpreadJS는 웹 애플리케이션에 엑셀 수준의 스프레드시트 기능을 내장할 수 있는 JavaScript 컴포넌트로, Chart.js나 ECharts 같은 별도 라이브러리 없이도 50종 이상의 차트를 스프레드시트 안에서 직접 생성·바인딩·내보낼 수 있는 내장 차트 엔진을 제공합니다.

React·Vue·Angular로 BI 대시보드나 리포팅 화면을 개발할 때, 차트 라이브러리와 스프레드시트 컴포넌트를 각각 붙이면 데이터 동기화 로직을 두 곳에 모두 작성해야 하고 스타일도 따로 조율해야 합니다. 프로젝트가 커질수록 이 중복 코드는 유지보수 부담으로 돌아옵니다.

이 글에서는 SpreadJS의 sheet.charts.add() API로 기본 차트를 생성하는 것부터 셀 데이터 자동 바인딩, 셀 안에 넣는 스파크라인, 막대와 꺾은선을 합친 콤보 차트, 이중 Y축 설정, 차트를 PNG 이미지나 PDF로 내보내는 방법까지 Vanilla JS 예제 코드와 함께 단계별로 설명합니다.

⭐ Key Points
이 글에서 다루는 핵심 내용
01 내장 차트 엔진: sheet.charts.add() 한 줄로 50종 이상 차트 타입을 별도 라이브러리 없이 즉시 추가합니다
02 자동 데이터 동기화: 셀 범위에 바인딩된 차트는 setValue() 호출 즉시 자동으로 반영됩니다
03 인라인 스파크라인: sheet.setSparkline() 으로 셀 안에 Line·Column·WinLoss 미니 차트를 직접 렌더링합니다
04 이중 축·이미지 추출: axisGroup: secondary 로 보조 Y축을 추가하고 toImageSrc() 로 차트를 PNG로 저장합니다
SpreadJS로 웹 앱에 차트 넣는 방법: 50종 타입부터 스파크라인까지 — 대표 이미지

SpreadJS addChart() API로 차트를 만드는 방법은?

SpreadJS는 50종 이상의 차트 타입을 sheet.charts.add() 단일 API로 즉시 생성하는 내장 차트 엔진을 제공합니다.

차트를 사용하려면 차트 플러그인( gc.spread.sheets.charts )을 추가로 로드해야 합니다. 차트 타입은 GC.Spread.Sheets.Charts.ChartType 열거형으로 지정하며, 아래 표가 실무에서 자주 쓰이는 주요 타입입니다.

열거형 값 차트 종류 활용 예
columnClustered 묶은 세로 막대 카테고리별 비교
line / lineMarkers 꺾은선 / 표식 꺾은선 시계열 추세
barClustered 묶은 가로 막대 순위 비교
pie 원형 비율·구성
combo 콤보 (혼합) 복합 지표
radar 방사형 역량 평가
funnel 깔때기 전환율·퍼널
sunburst 선버스트 계층 구조

addChart() 메서드의 파라미터 순서는 다음과 같습니다.

↗
50+
차트 타입
Column·Line·Pie·Radar·Sunburst 등 다양한 시각화
↗
3종
스파크라인
Line·Column·WinLoss 셀 내장 미니 차트
↗
1줄
차트 생성
sheet.charts.add() 단일 API 호출

아래 예제에서 지역별 분기 판매 실적을 묶은 세로 막대 차트로 표현해 보겠습니다.

STEP 1~2: CDN 참조 및 HTML 구조

STEP 3: 기본 차트 생성

실행 결과
💡 TIP
sheet.charts.all() 로 시트에 추가된 모든 차트를 배열로 가져올 수 있습니다. sheet.charts.get('SalesChart') 처럼 이름 기반 접근도 지원합니다.
SpreadJS addChart() API로 차트를 만드는 방법은? — SpreadJS 개념도

셀 값이 바뀌면 차트가 자동으로 갱신되게 하려면?

SpreadJS 차트는 셀 범위에 직접 바인딩되어, setValue() 로 셀 값을 변경하면 차트가 자동 갱신됩니다.

addChart() 의 dataRange 파라미터에 셀 주소 문자열(예: 'A1:B6' )을 지정하는 것만으로 바인딩이 완성됩니다. 이벤트 리스너나 별도 갱신 메서드 호출이 전혀 필요하지 않습니다. 아래 데모에서 버튼을 클릭할 때마다 셀 값이 변경되고 차트가 즉시 반응하는 것을 확인하세요.

실행 결과
ⓘ NOTE
시리즈를 동적으로 추가하려면 chart.series().add(seriesItem) , 제거하려면 chart.series().remove(index) 를 사용합니다. 각 seriesItem 에는 name , xValues , yValues 셀 주소를 지정합니다.
⭐ BEST PRACTICE
spread.suspendPaint() / spread.resumePaint() 쌍으로 데이터 설정 구간을 감싸면 불필요한 중간 렌더링을 방지해 초기 로딩 성능을 크게 향상시킵니다.

setSparkline()으로 셀 안에 미니 차트를 넣는 방법

스파크라인은 셀 안에 직접 삽입되는 미니 차트로, 별도 차트 영역 없이 데이터 추세를 한눈에 표현합니다.

sheet.setSparkline() 메서드 시그니처는 다음과 같습니다.

SpreadJS는 세 가지 스파크라인 타입( GC.Spread.Sheets.Sparklines.SparklineType )을 지원합니다.

타입 설명 활용
line 꺾은선 미니 차트 연속 추세
column 막대 미니 차트 크기 비교
winloss 승·패(양수/음수) 이진 결과

SparklineSetting 객체로 색상·굵기·마커 표시 여부를 세밀하게 제어할 수 있습니다. 아래 예제는 직원별 6개월 성과 데이터에 세 가지 스파크라인을 나란히 삽입합니다.

실행 결과
💡 TIP
스파크라인 셀을 더 넓게 사용하려면 sheet.addSpan(row, col, rowCount, colCount) 으로 셀을 병합한 뒤 setSparkline() 을 호출하세요. 스파크라인이 병합 영역 전체에 맞게 렌더링됩니다.
⭐ BEST PRACTICE
WinLoss 스파크라인은 값이 양수면 위쪽 바, 음수면 아래쪽 바를 표시합니다. 합격(80점 이상)/불합격 등 이진 결과를 양수/음수 변환해 입력하면 KPI 달성 여부 시각화에 최적입니다.
💡 TIP
SpreadJS는 Excel 호환 스파크라인(Line·Column·WinLoss) 외에도 수식 기반 스파크라인을 고유 기능으로 지원합니다. LINESPARKLINE() , COLUMNSPARKLINE() 등 20종 이상의 스파크라인을 셀 수식으로 직접 생성할 수 있어 훨씬 다양한 시각화가 가능합니다. → SpreadJS 스파크라인 수식 전체 가이드
setSparkline()으로 셀 안에 미니 차트를 넣는 방법 — SpreadJS 개념도

콤보 차트에서 이중 Y축을 구현하는 방법은?

콤보 차트는 두 가지 이상의 차트 타입을 결합하며, 이중 Y축으로 이질적인 지표를 하나의 차트에 표현합니다.

판매량(막대, 단위: 개)과 성장률(꺾은선, 단위: %)처럼 값의 범위와 단위가 완전히 다른 지표를 단일 Y축에 표시하면 한쪽 데이터가 납작해져 의미를 잃습니다. 이중 Y축(왼쪽·오른쪽)이 필요한 이유입니다.

SpreadJS에서 이중 Y축 콤보 차트를 만드는 방법은 다음과 같습니다.

  1. 01 기본 차트( columnClustered )를 생성합니다.
  2. 02 chart.series().add() 로 꺾은선 시리즈를 추가합니다.
  3. 03 추가 시리즈에 axisGroup: GC.Spread.Sheets.Charts.AxisGroup.secondary 를 지정합니다.
  4. 04 chart.axes() 로 보조 Y축 제목·포맷을 독립 설정하고, chart.axes(axes) 로 적용합니다.
실행 결과
⭐ IMPORTANT
axisGroup: GC.Spread.Sheets.Charts.AxisGroup.secondary (값: 1 )를 설정하면 해당 시리즈가 오른쪽 Y축에 플롯됩니다. 기본값은 primary (값: 0 , 왼쪽 Y축)입니다.
⚠ WARNING
axes.secondaryValue.format = '0%' 포맷은 소수( 0.28 )를 100배하여 28% 로 표시합니다. 따라서 원본 데이터는 반드시 소수 형태( 0.28 )로 입력해야 합니다. 28 로 입력하면 2800% 로 표시됩니다.

SpreadJS 차트를 이미지와 PDF로 내보내는 방법

보고서에서 차트를 이미지로 추출하거나 전체 워크북을 PDF로 내보내는 것은 기업 BI 시스템의 필수 기능입니다.

PNG 이미지로 차트를 저장하는 방법

chart.toImageSrc() 메서드는 차트를 PNG Base64 이미지 소스로 반환합니다. <img> 태그에 직접 표시하거나 파일로 다운로드할 수 있습니다.

실행 결과

워크북 전체를 PDF 파일로 출력하는 방법

spread.savePDF() 로 차트가 포함된 전체 워크북을 PDF 파일로 내보낼 수 있습니다. Print 플러그인과 PDF 플러그인을 순서대로 로드해야 합니다.

ⓘ NOTE
PDF 내보내기 전 sheet.printInfo().showGridLine(false) 으로 격자선을 숨기면 보고서 품질이 크게 향상됩니다. 인쇄 영역·여백·헤더·푸터 모두 printInfo() 객체로 세밀하게 제어합니다.
💡 TIP
용도별 선택 기준 — 단일 차트를 슬라이드·메일에 첨부할 때는 toImageSrc() 로 PNG 추출, 다중 시트와 차트가 포함된 완전한 보고서 문서가 필요할 때는 savePDF() 를 사용하세요.

개발자 FAQ: SpreadJS 차트 자주 묻는 질문

Q01

SpreadJS로 웹 앱에 차트를 추가하려면 어떻게 시작하나요?

먼저 차트 플러그인( gc.spread.sheets.charts.min.js )을 HTML에 로드해야 합니다. 그런 다음 sheet.charts.add(name, chartType, x, y, width, height, dataRange) 를 호출하면 됩니다. 차트 종류는 GC.Spread.Sheets.Charts.ChartType 열거형으로 50종 이상 중 선택합니다.

Q02

웹 스프레드시트에서 막대 그래프와 꺾은선 그래프를 한 화면에 같이 보여줄 수 있나요?

가능합니다. columnClustered 타입으로 기본 차트를 생성한 후, chart.series().add() 로 chartType: lineMarkers 시리즈를 추가하면 하나의 차트 안에 두 타입이 동시에 렌더링됩니다.

Q03

셀 안에 작은 미니 차트(스파크라인)를 넣으려면 어떻게 하나요?

sheet.setSparkline(row, col, dataRange, orientation, sparklineType, setting) 을 호출하면 됩니다. SparklineType 으로 line · column · winloss 중 하나를 고르고, SparklineSetting 객체로 색상·굵기·마커 표시 여부를 조정합니다.

Q04

SpreadJS 차트에 Y축을 두 개 쓰려면 어떻게 설정하나요?

보조 축에 표시할 시리즈에 axisGroup: GC.Spread.Sheets.Charts.AxisGroup.secondary 속성을 추가합니다. 이후 chart.axes().secondaryValue 로 보조 Y축의 제목과 포맷을 별도로 설정하고, chart.axes(axes) 를 호출해 적용합니다.

Q05

SpreadJS에서 셀 값을 바꿀 때마다 차트가 자동으로 새로 그려지나요?

네, 별도 이벤트 처리 없이도 자동으로 갱신됩니다. addChart() 의 dataRange 파라미터로 셀 범위를 지정해 두면, 이후 setValue() 로 해당 셀 값을 바꿀 때마다 차트가 즉시 다시 그려집니다.

MESCIUS SpreadJS

지금 바로 SpreadJS 를 무료로 체험해 보세요

30일 무료 체험판으로 모든 기능을 직접 확인하세요.

SpreadJS 무료 체험판 다운로드