SpreadJS로 웹 앱에 엑셀 다중 시트 기능 구현하는 방법
SpreadJS는 웹 애플리케이션에 Excel과 동일한 멀티시트 스프레드시트 기능을 제공하는 JavaScript 컴포넌트 라이브러리로, 단일 워크북 안에서 여러 개의 워크시트를 동적으로 생성·관리하고 시트 간 수식 연동·복사·이동·탭 UI 제어까지 엔터프라이즈 수준의 기능을 API 몇 줄로 구현할 수 있습니다.
React·Vue·Angular 또는 Vanilla JS로 웹 앱을 개발하다 보면 월별·팀별 데이터를 별도 탭으로 분리하거나, 여러 시트의 값을 하나의 집계 시트에 자동으로 합산해야 하는 요구사항을 마주치게 됩니다. HTML 테이블이나 일반 그리드 컴포넌트로는 이런 Excel 스타일의 다중 시트 구조를 직접 구현하기가 쉽지 않습니다.
SpreadJS를 사용하면 addSheet()
, removeSheet()
로 런타임에 시트를 자유롭게 추가·제거하고, =시트명!A1
수식 구문으로 시트 사이 데이터를 실시간으로 연동할 수 있습니다. 이 글에서는 멀티시트 구현에 필요한 핵심 API를 단계별 예제와 함께 살펴봅니다.
addSheet
, removeSheet
, name()
API를 사용하면 사용자 인터랙션에 반응해 시트를 즉시 생성·삭제·이름 변경할 수 있음
=시트명!A1
구문으로 서로 다른 시트 사이의 데이터를 수식으로 연결해 자동 집계
moveSheet()
로 탭 배치 순서를 원하는 대로 조정

JavaScript에서 SpreadJS 시트를 동적으로 추가·삭제·이름 변경하는 방법
SpreadJS는 GC.Spread.Sheets.Workbook
의 메서드로 런타임에 시트를 자유롭게 조작합니다. Excel과 동일한 방식으로 시트를 추가·삭제하며, 인덱스 또는 이름 기반으로 시트를 참조할 수 있습니다.
| 메서드 | 설명 |
|---|---|
addSheet(index, sheet)
|
지정 위치에 시트 추가 |
removeSheet(index)
|
인덱스 위치의 시트 삭제 |
getSheet(index)
|
인덱스로 시트 참조 반환 |
getSheetCount()
|
전체 시트 수 반환 |
getSheetFromName(name)
|
이름으로 시트 참조 반환 |
sheet.name(newName)
|
시트 이름 설정 (getter/setter) |
아래 데모에서 시트 추가·삭제·이름 변경을 직접 실행해보세요.
STEP 1: 라이브러리 참조
STEP 2: HTML 구조
STEP 3: JavaScript
getSheetFromName('이름')
으로 이름 기반 시트 참조가 가능합니다. 탭이 많은 워크북에서 인덱스 대신 이름으로 시트를 안전하게 찾아 코드 가독성을 높일 수 있습니다.다른 시트 셀을 수식으로 참조해 여러 시트 데이터를 실시간 연동하는 방법
SpreadJS는 Excel과 동일한 =시트명!셀주소
구문으로 다른 시트의 값을 수식에서 참조합니다. setFormula()
메서드에 시트 간 수식을 전달하면, 원본 시트 값 변경 시 참조 셀도 실시간으로 갱신됩니다.
STEP 2: HTML 구조
STEP 3: JavaScript
='Q1 매출'!B2
→ 공백 포함 시트명 참조
시트를 복사하고 순서를 바꿔 워크북 구조를 원하는 대로 재구성하는 방법
JSON 직렬화로 기존 시트를 그대로 복제하는 방법
SpreadJS에서 시트 전체를 복사할 때는 toJSON()
/ fromJSON()
직렬화를 활용합니다. 이 방식은 셀 데이터, 서식, 조건부 서식, 행/열 크기 등 모든 시트 정보를 보존합니다.
moveSheet()로 시트 탭 순서를 변경하는 방법
Workbook.moveSheet(fromIndex, toIndex)
메서드로 탭 순서를 즉시 변경합니다.
STEP 2: HTML 구조
STEP 3: JavaScript
toJSON()
/ fromJSON()
은 시트의 모든 상태(서식, 조건부 서식, 수식, 행/열 크기)를 완전히 복원합니다. 템플릿 시트를 미리 만들어두고 복사해 반복 작업을 자동화하는 패턴에 적합합니다.시트 탭 색상·숨김·편집 보호를 API로 제어하는 방법
시트 탭 UI를 코드로 제어하면 사용자에게 명확한 시각적 피드백을 제공하고, 데이터 무결성을 보호할 수 있습니다.
| API | 설명 | 예시 |
|---|---|---|
sheet.options.sheetTabColor
|
탭 색상 설정 | sheet.options.sheetTabColor = '#FF5722'
|
sheet.visible(flag)
|
탭 가시성 제어 | sheet.visible(false)
|
sheet.options.isProtected
|
셀 편집 보호 | sheet.options.isProtected = true
|
STEP 2: HTML 구조
STEP 3: JavaScript
sheet.visible(false)
로 시트를 숨겨도 시트 간 수식 참조는 유지됩니다. 민감 데이터는 탭 숨김만으로는 부족하며, isProtected
와 함께 적용해야 합니다.
월별 매출 시트를 연결해 분기 자동 집계 대시보드를 만드는 실전 예제
월별 시트에 데이터를 입력하면 분기합계 시트에 시트 간 수식이 자동 반영되는 실전 예제입니다. 분기합계 시트는 보호 설정으로 수식 변경을 차단합니다.
STEP 2: HTML 구조
STEP 3: JavaScript
spread.suspendPaint()
/ resumePaint()
쌍으로 대량 데이터 입력 시 화면 깜빡임을 방지하고 렌더링 성능을 크게 향상시킬 수 있습니다.개발자들이 자주 묻는 질문
SpreadJS 워크북에서 시트를 프로그래밍 방식으로 추가하거나 제거하려면 어떻게 하나요?
spread.addSheet(index, new GC.Spread.Sheets.Worksheet('이름'))
을 호출하면 지정한 인덱스 위치에 새 시트가 삽입되고, spread.removeSheet(index)
로 해당 위치의 시트를 제거할 수 있습니다. spread.getSheetCount()
로 현재 시트 수를 먼저 확인한 뒤 맨 끝에 추가하는 방식이 가장 많이 쓰입니다.
웹 스프레드시트에서 다른 시트에 있는 셀 값을 수식으로 가져오는 방법이 있나요?
sheet.setFormula(row, col, '=1월!B2')
형태로 호출하면 다른 시트의 셀 값을 수식에서 직접 참조할 수 있습니다. 시트 이름에 공백이 포함된 경우 ='Q1 매출'!B2
처럼 작은따옴표로 시트명을 감싸야 하며, 원본 셀의 값이 바뀌면 참조 결과도 자동으로 업데이트됩니다.
SpreadJS에서 기존 시트를 그대로 복제하거나 탭 위치를 바꾸는 API는 무엇인가요?
시트를 복사할 때는 sourceSheet.toJSON(obj)
→ 새 시트 생성 → newSheet.fromJSON(obj)
순서로 직렬화·역직렬화를 적용합니다. 탭 순서를 바꿀 때는 spread.moveSheet(fromIndex, toIndex)
한 줄로 처리하고, setActiveSheetIndex()
로 포커스를 함께 이동하면 사용자 경험이 자연스럽습니다.
여러 시트에 나뉜 월별 데이터를 별도 집계 시트 하나에 자동으로 합산하려면 어떻게 구현하나요?
totalSheet.setFormula(r+1, 1, '=1월!B2')
형식으로 각 월 시트의 값을 집계 시트에 연결하고, =SUM(B2:D2)
로 가로 방향 합산을 적용하면 됩니다. 월별 시트 데이터가 변경되면 집계 시트가 자동으로 갱신되어 별도 집계 로직을 따로 작성할 필요가 없습니다.
SpreadJS에서 시트 탭 색상을 지정하거나 특정 시트를 숨기는 코드는 어떻게 작성하나요?
탭 색상은 sheet.tabColor('#FF5722')
로 지정하고, 시트 숨김과 표시는 각각 sheet.visible(false)
/ sheet.visible(true)
로 전환합니다. 편집을 잠그려면 sheet.options.isProtected = true
를 적용하면 되며, 세 옵션을 조합하면 상태별 시각화와 데이터 보호를 한 번에 구현할 수 있습니다.
