SpreadJS 블로그 MESCIUS 기술 블로그 ·

SpreadJS로 웹 엑셀 편집기 만드는 방법: 그리드 컴포넌트 전환 가이드

웹 애플리케이션에서 "엑셀처럼 동작하는 화면"을 만들어야 한다는 요구는 프론트엔드 개발자라면 한 번쯤 받아봤을 겁니다. SpreadJS(스프레드JS)는 MESCIUS가 개발한 JavaScript 스프레드시트 컴포넌트로, 브라우저에서 Excel 수식·xlsx Import/Export·피벗 테이블·조건부 서식을 그대로 구현할 수 있도록 설계되었습니다.

국내 SI·공공기관 프로젝트에서는 IBSheet나 RealGrid 같은 그리드 솔루션이 오랫동안 표준처럼 사용되어 왔습니다. 단순한 데이터 조회·편집 화면에서는 충분하지만, "재무보고서의 =VLOOKUP 수식을 웹에서도 계산해야 한다"거나 "xlsx 파일을 서식 그대로 올리고 내려야 한다"는 요구가 생기면 그리드 컴포넌트만으로는 한계가 명확해집니다.

이 글은 SpreadJS를 처음 접하는 웹·프론트엔드 개발자를 위해, 기존 그리드와의 기능 차이부터 실제 마이그레이션 코드 패턴까지 단계적으로 설명합니다. Angular·React·Vue·Vanilla JS 어느 환경에서도 적용할 수 있는 실전 예시를 함께 제공합니다.

⭐ Key Points
이 글에서 다루는 핵심 내용
01 그리드 컴포넌트 한계: IBSheet·RealGrid는 데이터 표시 특화 설계로 Excel 수식 엔진·조건부 서식·xlsx 서식 보존 기능이 제한적입니다
02 SpreadJS 핵심 차별점: 500개 이상 Excel 호환 수식과 xlsx 완전 Import/Export를 지원하는 웹용 엔터프라이즈 스프레드시트 컴포넌트입니다
03 마이그레이션 비용 최소화: 기존 colModel ·이벤트 기반 코드를 bindColumns · CellChanged API로 전환해 그리드 로직을 1:1 매핑할 수 있습니다
04 현대적 프레임워크 통합: Angular·React·Vue 3대 프레임워크 공식 래퍼를 npm으로 제공해 기존 빌드 파이프라인에 즉시 통합할 수 있습니다
SpreadJS로 웹 엑셀 편집기 만드는 방법: 그리드 컴포넌트 전환 가이드 — 대표 이미지

그리드와 스프레드시트 컴포넌트의 차이: 웹 개발에서 무엇을 선택해야 할까?

IBSheet와 RealGrid는 서버에서 내려온 데이터를 빠르게 표시하고 편집하는 데 최적화된 그리드 컴포넌트입니다. 반면 SpreadJS(스프레드JS) by MESCIUS는 Excel 엔진을 웹에 통째로 이식한 스프레드시트 컴포넌트로, 수식 연산·서식 보존·차트·피벗 테이블까지 Excel 기능을 브라우저에서 그대로 구현합니다.

기능 IBSheet RealGrid SpreadJS
Excel 수식 엔진 (500+) ✗ ✗ ✓
xlsx 서식 보존 Import/Export 제한적 제한적 ✓ 완전 지원
조건부 서식 제한적 제한적 ✓
피벗 테이블 ✗ ✗ ✓
차트 내장 ✗ ✗ ✓
Angular/React/Vue 공식 래퍼 미제공 미제공 ✓
npm 패키지 미제공 일부 제공 ✓
ⓘ NOTE
IBSheet는 ActiveX 기반 제품의 웹 포팅으로 태어났고, RealGrid 역시 데이터 그리드 퍼포먼스에 집중한 설계입니다. 단순 조회·편집 화면에서는 충분하지만, Excel 호환 기능이 필요한 업무에서는 구조적 한계에 부딪힙니다.
그리드와 스프레드시트 컴포넌트의 차이: 웹 개발에서 무엇을 선택해야 할까? — SpreadJS 개념도

웹 앱에서 엑셀 수식·피벗 테이블이 필요할 때: 그리드의 한계를 넘는 방법

IBSheet의 한계: Excel 호환 수식 엔진이 없어 =SUM() , =VLOOKUP() 같은 수식을 셀에 직접 입력할 수 없습니다. 합계·집계는 서버 측 계산에 의존해야 하며, 재무·회계 시스템에서 자주 요구되는 복잡한 수식 로직을 클라이언트에서 처리하기 어렵습니다. xlsx 내보내기 시에도 셀 병합·글꼴·테두리 등 서식이 소실되는 경우가 많아 보고서 품질에 영향을 미칩니다.

IBSheet는 또한 스크립트 태그 방식으로만 제공되어 Webpack/Vite 기반 현대적 프론트엔드 빌드 환경과의 통합에 추가 설정이 필요하고, React·Vue·Angular 공식 컴포넌트가 없어 프레임워크 프로젝트에서 직접 래핑(wrapping) 코드를 작성해야 합니다.

RealGrid의 한계: 대용량 데이터 처리에서 강점을 보이지만, 피벗 테이블·조건부 서식·차트 등 스프레드시트 수준의 분석 기능은 기본 제공하지 않습니다. 경영 대시보드나 재무 분석 화면을 구현하려면 별도 차트 라이브러리 연동과 추가 개발이 필요해 유지보수 비용이 증가합니다.

RealGrid 역시 클라이언트 수식 엔진이 없어 셀에 수식을 직접 입력하는 기능을 지원하지 않으며, xlsx Import 시 조건부 서식·수식·피벗 정보는 유실됩니다. Excel 기반 보고서 양식을 웹에 그대로 올려야 하는 프로젝트에서는 결국 별도 스프레드시트 라이브러리를 병행 도입하게 됩니다.

⚠ WARNING
재무보고서·예산집행표·원가계산서처럼 Excel 서식을 그대로 웹에서 재현해야 하는 시스템은 그리드 컴포넌트가 아닌 스프레드시트 컴포넌트가 적합합니다. 그리드 위에 스프레드시트 기능을 직접 구현하면 유지보수 부담이 지속적으로 증가합니다.

SpreadJS 마이그레이션 실전: 기존 그리드 코드를 새 API로 전환하는 방법

기존 IBSheet 프로젝트의 핵심 자산은 컬럼 정의( colModel )와 이벤트 핸들러입니다. SpreadJS는 이를 각각 bindColumns 와 CellChanged 이벤트로 1:1 매핑할 수 있어 전환 비용을 크게 줄일 수 있습니다.

아래 예시는 공공 기관 예산 집행 현황 시스템을 SpreadJS로 구현한 코드입니다. IBSheet colModel 에 해당하는 컬럼 정의를 bindColumns 로 설정하고, 집행률 열에 조건부 서식을 적용합니다.

실행 결과
💡 TIP
bindColumns 의 formatter 속성은 Excel 표시 형식 문자열을 그대로 사용합니다. 기존 IBSheet format 속성값( #,##0 , 0.00 등)을 대부분 그대로 이전할 수 있습니다.

다음 예시는 IBSheet의 onAfterChange / RealGrid의 onCellCommit 이벤트를 SpreadJS CellChanged 로 매핑하고, 클라이언트 수식 엔진을 활용하는 패턴입니다. 그리드 컴포넌트에서는 서버 왕복이 필요했던 합계 계산을 =SUM() 수식 하나로 대체할 수 있습니다.

실행 결과
⭐ IMPORTANT
CellChanged 이벤트에서 info.propertyName === 'value' 조건 체크가 필수입니다. 스타일·수식·주석 변경 등 다른 셀 속성 변화에도 동일 이벤트가 발생하기 때문입니다.
SpreadJS 마이그레이션 실전: 기존 그리드 코드를 새 API로 전환하는 방법 — SpreadJS 개념도

대용량 데이터를 웹에서 처리하려면: SpreadJS 가상화 렌더링 성능 비교

IBSheet와 RealGrid 모두 가상화 렌더링(Virtualization)을 지원하지만, 수식 연산·조건부 서식·차트가 동시에 적용된 대용량 시트에서는 SpreadJS의 통합 렌더링 파이프라인이 유리합니다.

  • ✓ SpreadJS: 수식 계산, 조건부 서식, 차트 데이터를 단일 렌더링 사이클에서 처리 → DOM 리플로우 최소화
  • ✓ IBSheet: 수식 결과를 서버에서 계산 후 전달해야 하므로 네트워크 왕복 지연 발생, 클라이언트 계산 불가
  • ✓ RealGrid: 클라이언트 수식 엔진 없이 DOM 기반 렌더링 → 셀 수 증가 시 렌더링 부하 증가
⭐ BEST PRACTICE
10만 행 이상 데이터 시나리오에서 SpreadJS는 setRowCount() + 가상화 렌더링으로 실제 DOM 엘리먼트 수를 뷰포트 범위로 한정하고, requestAnimationFrame 기반 페인트 사이클로 60FPS 스크롤을 유지합니다.
↗
500+
내장 수식
Excel 호환 수식 엔진
↗
100만+
셀 처리
가상화 렌더링 지원
↗
3개
프레임워크
Angular·React·Vue 공식 지원

SpreadJS 도입 전 확인할 것: 비용·기술지원·프레임워크 통합 가이드

도입을 결정할 때 기능 외에 라이선스 구조, 기술지원, 현대적 개발 환경과의 통합성도 중요한 판단 기준입니다.

항목 IBSheet RealGrid SpreadJS
라이선스 방식 사이트 라이선스 사이트/개발자 개발자 라이선스
국내 기술지원 국내 제공 국내 제공 MESCIUS 한국 지원
Angular 공식 래퍼 미제공 미제공 ✓ 제공
React 공식 래퍼 미제공 미제공 ✓ 제공
Vue 공식 래퍼 미제공 미제공 ✓ 제공
npm 패키지 배포 미제공 일부 제공 ✓ @mescius/spread-sheets
TypeScript 지원 제한적 일부 ✓ 완전 지원
ⓘ NOTE
IBSheet와 RealGrid는 스크립트 태그 방식으로 제공되어 Webpack/Vite 기반 빌드 파이프라인에 통합하려면 별도 설정이 필요합니다. SpreadJS는 npm install @mescius/spread-sheets 한 줄로 설치하고 import 만으로 즉시 사용할 수 있어, Angular·React·Vue 프로젝트에서 추가 래핑 없이 공식 컴포넌트를 그대로 쓸 수 있습니다.

개발자가 자주 묻는 질문

Q01

웹 프로젝트에서 IBSheet 대신 SpreadJS를 사용해야 하는 이유가 무엇인가요?

IBSheet는 데이터 그리드 표시에 최적화되어 클라이언트 Excel 수식 엔진을 내장하지 않지만, SpreadJS는 500개 이상 Excel 호환 수식과 xlsx 서식 완전 Import/Export를 기본으로 제공합니다.

Q02

RealGrid로 피벗 테이블이나 차트를 구현하기 어려울 때 어떤 대안을 쓸 수 있나요?

SpreadJS는 피벗 테이블·조건부 서식·차트 등 Excel 기능을 완전 지원하여, 재무·회계 웹 시스템처럼 복잡한 스프레드시트가 필요한 프로젝트에 최적인 선택입니다.

Q03

JavaScript로 웹 앱에서 =SUM, =VLOOKUP 같은 엑셀 수식을 클라이언트에서 직접 실행할 수 있나요?

SpreadJS를 사용하면 =SUM , =VLOOKUP , =IF 등 500개 이상 Excel 호환 수식을 브라우저에서 직접 실행할 수 있고, xlsx 파일을 서식 손실 없이 Import/Export할 수 있어 보고서·회계 시스템 개발에 적합합니다.

Q04

IBSheet 기반 코드를 SpreadJS로 전환할 때 어떤 API를 가장 먼저 바꿔야 하나요?

colModel 정의를 bindColumns 로, onAfterChange 이벤트를 CellChanged 로 대응시키면 핵심 기능을 1:1 전환할 수 있습니다. 본문의 코드 예시를 활용하면 실제 프로젝트에 바로 적용할 수 있습니다.

Q05

웹 개발에서 데이터 그리드와 스프레드시트 컴포넌트 중 어떤 것을 선택해야 하나요?

데이터 그리드(IBSheet·RealGrid)는 서버 데이터 조회·편집에 최적화되어 있고, 스프레드시트 컴포넌트(SpreadJS)는 Excel 수식 엔진·서식·차트·피벗 테이블을 포함한 완전한 Excel 기능을 웹에서 구현합니다.

MESCIUS SpreadJS

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

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

SpreadJS 무료 체험판 다운로드