SpreadJS 블로그 MESCIUS 기술 블로그 ·

SpreadJS로 웹 앱에 엑셀 다중 시트 기능 구현하는 방법

SpreadJS는 웹 애플리케이션에 Excel과 동일한 멀티시트 스프레드시트 기능을 제공하는 JavaScript 컴포넌트 라이브러리로, 단일 워크북 안에서 여러 개의 워크시트를 동적으로 생성·관리하고 시트 간 수식 연동·복사·이동·탭 UI 제어까지 엔터프라이즈 수준의 기능을 API 몇 줄로 구현할 수 있습니다.

React·Vue·Angular 또는 Vanilla JS로 웹 앱을 개발하다 보면 월별·팀별 데이터를 별도 탭으로 분리하거나, 여러 시트의 값을 하나의 집계 시트에 자동으로 합산해야 하는 요구사항을 마주치게 됩니다. HTML 테이블이나 일반 그리드 컴포넌트로는 이런 Excel 스타일의 다중 시트 구조를 직접 구현하기가 쉽지 않습니다.

SpreadJS를 사용하면 addSheet() , removeSheet() 로 런타임에 시트를 자유롭게 추가·제거하고, =시트명!A1 수식 구문으로 시트 사이 데이터를 실시간으로 연동할 수 있습니다. 이 글에서는 멀티시트 구현에 필요한 핵심 API를 단계별 예제와 함께 살펴봅니다.

⭐ Key Points
이 글에서 다루는 핵심 내용
01 시트 동적 추가·제거: addSheet , removeSheet , name() API를 사용하면 사용자 인터랙션에 반응해 시트를 즉시 생성·삭제·이름 변경할 수 있음
02 크로스시트 수식 연동: =시트명!A1 구문으로 서로 다른 시트 사이의 데이터를 수식으로 연결해 자동 집계
03 시트 복제·재배치: JSON 직렬화로 기존 시트를 그대로 복제하고, moveSheet() 로 탭 배치 순서를 원하는 대로 조정
04 탭 시각화 및 보호: 색상·가시성·보호 옵션으로 상태를 시각화하고 엔터프라이즈 수준의 시트 관리 UI를 구성
SpreadJS로 웹 앱에 엑셀 다중 시트 기능 구현하는 방법 — 대표 이미지

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

실행 결과
💡 TIP
getSheetFromName('이름') 으로 이름 기반 시트 참조가 가능합니다. 탭이 많은 워크북에서 인덱스 대신 이름으로 시트를 안전하게 찾아 코드 가독성을 높일 수 있습니다.

다른 시트 셀을 수식으로 참조해 여러 시트 데이터를 실시간 연동하는 방법

SpreadJS는 Excel과 동일한 =시트명!셀주소 구문으로 다른 시트의 값을 수식에서 참조합니다. setFormula() 메서드에 시트 간 수식을 전달하면, 원본 시트 값 변경 시 참조 셀도 실시간으로 갱신됩니다.

STEP 2: HTML 구조

STEP 3: JavaScript

실행 결과
⭐ IMPORTANT
시트 이름에 공백이나 특수문자가 포함된 경우 반드시 작은따옴표로 감쌉니다.
='Q1 매출'!B2 → 공백 포함 시트명 참조
다른 시트 셀을 수식으로 참조해 여러 시트 데이터를 실시간 연동하는 방법 — SpreadJS 개념도

시트를 복사하고 순서를 바꿔 워크북 구조를 원하는 대로 재구성하는 방법

JSON 직렬화로 기존 시트를 그대로 복제하는 방법

SpreadJS에서 시트 전체를 복사할 때는 toJSON() / fromJSON() 직렬화를 활용합니다. 이 방식은 셀 데이터, 서식, 조건부 서식, 행/열 크기 등 모든 시트 정보를 보존합니다.

moveSheet()로 시트 탭 순서를 변경하는 방법

Workbook.moveSheet(fromIndex, toIndex) 메서드로 탭 순서를 즉시 변경합니다.

STEP 2: HTML 구조

STEP 3: JavaScript

실행 결과
ⓘ NOTE
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

실행 결과
⚠ WARNING
sheet.visible(false) 로 시트를 숨겨도 시트 간 수식 참조는 유지됩니다. 민감 데이터는 탭 숨김만으로는 부족하며, isProtected 와 함께 적용해야 합니다.
⭐ BEST PRACTICE
탭 색상을 업무 상태(확정=초록, 검토=주황, 보류=빨강)에 매핑하면 Excel과 동일한 UX를 제공해 사용자 학습 비용을 최소화할 수 있습니다.
시트 탭 색상·숨김·편집 보호를 API로 제어하는 방법 — SpreadJS 개념도

월별 매출 시트를 연결해 분기 자동 집계 대시보드를 만드는 실전 예제

월별 시트에 데이터를 입력하면 분기합계 시트에 시트 간 수식이 자동 반영되는 실전 예제입니다. 분기합계 시트는 보호 설정으로 수식 변경을 차단합니다.

STEP 2: HTML 구조

STEP 3: JavaScript

실행 결과
💡 TIP
spread.suspendPaint() / resumePaint() 쌍으로 대량 데이터 입력 시 화면 깜빡임을 방지하고 렌더링 성능을 크게 향상시킬 수 있습니다.

개발자들이 자주 묻는 질문

Q01

SpreadJS 워크북에서 시트를 프로그래밍 방식으로 추가하거나 제거하려면 어떻게 하나요?

spread.addSheet(index, new GC.Spread.Sheets.Worksheet('이름')) 을 호출하면 지정한 인덱스 위치에 새 시트가 삽입되고, spread.removeSheet(index) 로 해당 위치의 시트를 제거할 수 있습니다. spread.getSheetCount() 로 현재 시트 수를 먼저 확인한 뒤 맨 끝에 추가하는 방식이 가장 많이 쓰입니다.

Q02

웹 스프레드시트에서 다른 시트에 있는 셀 값을 수식으로 가져오는 방법이 있나요?

sheet.setFormula(row, col, '=1월!B2') 형태로 호출하면 다른 시트의 셀 값을 수식에서 직접 참조할 수 있습니다. 시트 이름에 공백이 포함된 경우 ='Q1 매출'!B2 처럼 작은따옴표로 시트명을 감싸야 하며, 원본 셀의 값이 바뀌면 참조 결과도 자동으로 업데이트됩니다.

Q03

SpreadJS에서 기존 시트를 그대로 복제하거나 탭 위치를 바꾸는 API는 무엇인가요?

시트를 복사할 때는 sourceSheet.toJSON(obj) → 새 시트 생성 → newSheet.fromJSON(obj) 순서로 직렬화·역직렬화를 적용합니다. 탭 순서를 바꿀 때는 spread.moveSheet(fromIndex, toIndex) 한 줄로 처리하고, setActiveSheetIndex() 로 포커스를 함께 이동하면 사용자 경험이 자연스럽습니다.

Q04

여러 시트에 나뉜 월별 데이터를 별도 집계 시트 하나에 자동으로 합산하려면 어떻게 구현하나요?

totalSheet.setFormula(r+1, 1, '=1월!B2') 형식으로 각 월 시트의 값을 집계 시트에 연결하고, =SUM(B2:D2) 로 가로 방향 합산을 적용하면 됩니다. 월별 시트 데이터가 변경되면 집계 시트가 자동으로 갱신되어 별도 집계 로직을 따로 작성할 필요가 없습니다.

Q05

SpreadJS에서 시트 탭 색상을 지정하거나 특정 시트를 숨기는 코드는 어떻게 작성하나요?

탭 색상은 sheet.tabColor('#FF5722') 로 지정하고, 시트 숨김과 표시는 각각 sheet.visible(false) / sheet.visible(true) 로 전환합니다. 편집을 잠그려면 sheet.options.isProtected = true 를 적용하면 되며, 세 옵션을 조합하면 상태별 시각화와 데이터 보호를 한 번에 구현할 수 있습니다.

MESCIUS SpreadJS

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

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

SpreadJS 무료 체험판 다운로드