SpreadJS 블로그 MESCIUS 기술 블로그 ·

SpreadJS로 웹 피벗 테이블 구현하기: 집계·드릴다운·슬라이서 완성

웹 프로젝트에서 "엑셀처럼 집계를 바꾸고, 행을 접었다 펼치고, 슬라이서로 필터링하는" 피벗 테이블 기능을 직접 구현해야 한다면, SpreadJS의 GC.Spread.Pivot API가 가장 빠른 해답입니다. SpreadJS는 MESCIUS가 개발한 JavaScript 스프레드시트 라이브러리로, 순수 JavaScript 몇 줄만으로 엑셀 수준의 피벗 테이블·동적 집계·드릴다운·슬라이서를 웹 앱에 추가할 수 있습니다.

React·Vue·Angular로 BI 대시보드나 ERP 분석 화면을 개발하다 보면 피벗 집계 로직을 직접 짜야 하는 상황을 마주치게 됩니다. 이를 처음부터 구현하면 수백 줄의 커스텀 코드가 필요하지만, SpreadJS 피벗 플러그인 한 줄을 추가하면 집계 전환·드릴다운·슬라이서가 모두 준비됩니다. 서버 처리 없이 클라이언트 사이드에서 동작하므로 기존 프레임워크에 그대로 통합할 수 있습니다.

이 가이드에서는 sheet.pivotTables.add() 로 첫 번째 피벗을 만드는 것부터 시작해, 런타임 집계 함수 전환, collapse() API로 계층 드릴다운 처리, 슬라이서 연결로 다차원 필터링을 완성하는 과정을 단계별 실행 코드와 함께 설명합니다.

⭐ Key Points
이 글에서 다루는 핵심 내용
01 GC.Spread.Pivot: SpreadJS 피벗 테이블 전용 API — add() 한 번으로 행·열·값·필터 필드 구성 완료
02 11가지 집계 함수: addCalcField 로 커스텀 수식 필드까지 추가해 다양한 비즈니스 분석 지표에 대응
03 collapse() API · 슬라이서(Slicer): 계층 드릴다운과 다차원 필터링으로 엑셀 수준 분석 UX 완성
04 3가지 레이아웃 · 조건부 서식: 컴팩트·아웃라인·테이블 형식을 런타임에 전환해 보고서 가독성 최적화
SpreadJS로 웹 피벗 테이블 구현하기: 집계·드릴다운·슬라이서 완성 — 대표 이미지

SpreadJS에서 피벗 테이블을 만드는 방법 — GC.Spread.Pivot API 기본 구조

SpreadJS 피벗 테이블은 PivotTableManager (시트의 pivotTables 속성)와 GC.Spread.Pivot.PivotTable 클래스로 관리됩니다. 데이터 소스로 테이블 이름이나 셀 범위를 지정하고, add() 메서드로 행·열·값·필터 필드를 구성하면 즉시 피벗 뷰가 렌더링됩니다.

피벗 테이블 기능은 핵심 라이브러리 외에 피벗 플러그인을 별도로 로드해야 합니다.

STEP 1: 라이브러리 참조 (CDN)

STEP 2: HTML 구조

STEP 3: JavaScript 코드

실행 결과
ⓘ NOTE
suspendLayout() / resumeLayout() 사이에 필드를 한꺼번에 추가하면 렌더링이 한 번만 발생하여 성능이 크게 향상됩니다. 필드 수가 많을수록 효과가 두드러집니다.
💡 TIP
데이터 소스는 반드시 테이블(table) 로 등록해야 합니다. sheet.tables.add() 를 통해 등록하면 원본 데이터 변경 시 pivotTable.updateSource() 로 피벗 결과를 즉시 갱신할 수 있습니다.

집계 함수를 실시간으로 전환하는 방법 — SUM·COUNT·AVERAGE와 커스텀 수식 필드

SpreadJS 피벗 테이블은 GC.Pivot.SubtotalType 열거형으로 11가지 집계 방식을 지원합니다. pivotTable.subTotalType(displayName, type) 메서드로 런타임에 집계 함수를 교체할 수 있으며, addCalcField() 로 수식 기반 커스텀 필드도 추가 가능합니다.

STEP 2: HTML 구조

STEP 3: JavaScript 코드

실행 결과
⭐ IMPORTANT
subTotalType() 의 첫 번째 인수는 add() 시 지정한 displayName(표시 이름)입니다. 소스 필드명( '매출액' )이 아닌 표시 이름( '집계값' )을 사용해야 합니다.

커스텀 비즈니스 로직이 필요하다면 addCalcField() 로 수식 필드를 정의할 수 있습니다:

↗
11가지
집계 함수
SUM·COUNT·AVG·MAX·MIN·STDEV·VAR 등 완비
↗
3가지
레이아웃 형식
컴팩트·아웃라인·테이블 형식 런타임 전환
↗
다중
슬라이서 동기화
1개 슬라이서로 복수 피벗 테이블 필터 제어

피벗 테이블 드릴다운을 구현하는 방법 — collapse API로 계층 데이터 탐색

SpreadJS 피벗 테이블의 드릴다운은 pivotTable.collapse(fieldName, item, isCollapse) 메서드로 구현합니다. 행·열 필드의 특정 항목을 접거나 펼쳐 계층 데이터를 단계별로 탐색할 수 있습니다.

피벗 테이블 드릴다운을 구현하는 방법 — collapse API로 계층 데이터 탐색 — SpreadJS 개념도

STEP 2: HTML 구조

STEP 3: JavaScript 코드

실행 결과
💡 TIP
pivotTable.options.showDrill = false 로 +/- 버튼을 숨기면, 프로그래밍 방식으로만 드릴다운을 제어하는 완전한 커스텀 UI를 구성할 수 있습니다.
⭐ BEST PRACTICE
셀 클릭 이벤트와 드릴다운을 연동하려면 spread.bind(GC.Spread.Sheets.Events.CellClick, callback) 내에서 pivotTable.collapse() 를 호출하세요. pivotTable.getNodeInfo(row, col) 로 클릭된 셀의 필드 정보를 파악해 드릴다운 대상을 동적으로 결정할 수 있습니다.

슬라이서를 피벗 테이블에 연결하는 방법 — 다차원 필터링 UX 구현

슬라이서(Slicer)는 피벗 테이블에 시각적 인터랙티브 필터를 추가하는 기능입니다. sheet.slicers.add() 로 생성하고, slicer.connectPivotTable() 로 여러 피벗 테이블에 동시 연결하면 하나의 슬라이서로 여러 뷰를 동기화할 수 있습니다.

슬라이서를 피벗 테이블에 연결하는 방법 — 다차원 필터링 UX 구현 — SpreadJS 개념도

STEP 2: HTML 구조

STEP 3: JavaScript 코드

실행 결과
ⓘ NOTE
슬라이서는 startRow() / startColumn() 으로 셀 기준 위치를, width() / height() 로 크기를 지정합니다. 픽셀 기준으로 배치하려면 position(new GC.Spread.Sheets.Point(x, y)) 를 사용합니다.
💡 TIP
동일한 데이터 소스를 공유하는 두 개의 피벗 테이블에 하나의 슬라이서를 연결하려면, 슬라이서 생성 후 slicer.connectPivotTable('secondPivotName') 을 추가로 호출하세요. 이후 슬라이서 클릭이 두 피벗 테이블에 동시 반영됩니다.

피벗 테이블 레이아웃과 조건부 서식 바꾸기 — 보고서 가독성 높이는 방법

SpreadJS 피벗 테이블은 컴팩트·아웃라인·테이블 3가지 레이아웃을 런타임에 전환할 수 있습니다. pivotTable.layoutType(type) 으로 즉시 변경하고, addConditionalRule() 로 값 셀에 색상 스케일을 적용해 데이터 분포를 시각화합니다.

STEP 2: HTML 구조

STEP 3: JavaScript 코드

실행 결과
ⓘ NOTE
addConditionalRule() 의 { dataOnly: true } 옵션은 헤더와 소계를 제외한 순수 데이터 셀에만 서식을 적용합니다. 특정 필드 항목에만 서식을 한정하려면 references: [{ fieldName: '지역', items: ['서울'] }] 옵션을 추가하세요.
⚠ WARNING
addConditionalRule() 은 중복 호출 시 규칙이 누적됩니다. 기존 서식을 교체하려면 removeConditionalRule() 로 기존 규칙을 제거한 뒤 새 규칙을 추가하세요.

자주 하는 질문

Q01

SpreadJS로 피벗 테이블을 만들려면 어떤 코드를 써야 하나요?

sheet.pivotTables.add(name, tableSource, row, col, layoutType, theme) 를 호출해 피벗 테이블 인스턴스를 생성하고, pivotTable.add(sourceName, displayName, fieldType, subtotalType) 로 행·열·값·필터 각 필드를 추가합니다. 피벗 플러그인( gc.spread.pivot.pivottables.js )을 SpreadJS 본체보다 먼저 로드해야 합니다.

Q02

웹 프로젝트에서 엑셀처럼 피벗 테이블 기능을 넣으려면 어떤 라이브러리를 써야 하나요?

SpreadJS의 GC.Spread.Pivot API를 사용하면 별도 서버 처리 없이 클라이언트 사이드에서 피벗 테이블 생성, 동적 집계 전환, 드릴다운, 슬라이서 연동을 모두 처리할 수 있습니다. React·Vue·Angular 프레임워크에 별도 어댑터 없이 바로 통합됩니다.

Q03

피벗 테이블에서 항목을 클릭했을 때 드릴다운이 작동하게 하려면 어떻게 해야 하나요?

pivotTable.collapse(fieldName, item, isCollapse) 메서드가 접기·펼치기를 담당합니다. spread.bind(GC.Spread.Sheets.Events.CellClick, callback) 이벤트 핸들러 안에서 pivotTable.getNodeInfo(row, col) 로 클릭된 노드를 확인한 뒤 collapse() 를 호출하면 클릭 위치에 따라 드릴다운이 작동합니다.

Q04

피벗 테이블 옆에 슬라이서를 추가하고 클릭으로 필터링하게 만드는 방법은?

sheet.slicers.add(name, pivotTableName, fieldName, style, SlicerType.pivotTable) 를 호출하면 슬라이서가 지정한 피벗 테이블에 자동으로 연결됩니다. 여러 피벗 테이블을 동시에 필터링하려면 slicer.connectPivotTable('otherPivotName') 으로 추가 연결합니다.

Q05

BI 대시보드나 ERP 화면에 피벗 테이블을 직접 구현해야 한다면 어떤 방법이 있나요?

SpreadJS는 JavaScript만으로 엑셀 수준의 피벗 테이블을 웹 화면에 완성할 수 있는 라이브러리입니다. 동적 집계·드릴다운·슬라이서를 코드로 완전히 제어할 수 있으며, React·Vue·Angular를 비롯한 모든 프레임워크와 통합해 기존 웹 프로젝트에 바로 적용할 수 있습니다.

MESCIUS SpreadJS

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

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

SpreadJS 무료 체험판 다운로드