SpreadJS로 웹 엑셀 편집기 만들기: jspreadsheet 대비 차이점과 선택 기준
React·Vue·Angular 등 현대 프레임워크로 웹 앱을 개발하다 보면 반드시 '브라우저에서 엑셀처럼 편집되는 테이블'이 필요한 순간이 옵니다. GitHub에서 jspreadsheet를 발견하고 간단한 예제를 돌려보면 초기 세팅이 쉽고 가볍다는 느낌을 받습니다. 하지만 고객사에서 받은 실제 xlsx 파일을 적용하거나 수만 행의 업무 데이터를 넣기 시작하면, 오픈소스의 한계가 하나씩 모습을 드러냅니다. SpreadJS는 이 간극을 채우기 위해 설계된 엔터프라이즈 JavaScript 스프레드시트 컴포넌트로, 500개 이상의 Excel 호환 수식, xlsx 서식 완전 보존, 100만+ 셀 가상화 렌더링을 웹 앱에서 구현할 수 있게 해줍니다.
jspreadsheet의 MIT 무료 라이선스는 프로토타입과 소규모 사내 도구에서 큰 장점입니다. 문제는 프로젝트가 성장하면서 요구사항이 달라질 때입니다. 담당자가 넘겨준 xlsx 파일에서 색상과 테두리가 모두 사라지거나, VLOOKUP 수식이 #NAME?
오류를 반환하거나, 5만 건 이상 데이터를 불러올 때 브라우저가 느려지는 상황은 오픈소스 라이브러리의 구조적 한계에서 비롯됩니다.
이 글에서는 jspreadsheet CE와 Pro 각 버전의 실제 기능 범위를 항목별로 분석하고, SpreadJS와의 차이를 직접 실행해볼 수 있는 코드 예제로 비교합니다. 또한 jspreadsheet에서 SpreadJS로 전환할 때 데이터 바인딩·이벤트·xlsx Import/Export를 어떻게 교체하는지, 실무에서 바로 적용 가능한 코드 패턴으로 정리했습니다.

jspreadsheet CE·Pro는 실무에서 어디서 막히는가
jspreadsheet는 외부 의존성 없는 경량 오픈소스 스프레드시트로, 간단한 데이터 입력 UI를 빠르게 구현할 수 있는 것이 최대 강점입니다.
Community Edition(CE) — 어떤 용도에 적합한가
jspreadsheet CE는 순수 JavaScript로 동작하며 번들 크기가 작아 팀 내 소규모 도구, 해커톤, PoC에 적합합니다. 배열·JSON 기반 데이터를 즉시 바인딩하고 CSV 처리에도 편리합니다. 그러나 기업 시스템 도입 시 아래 한계가 중요해집니다.
- ✓ xlsx 서식 손실: 내보낸 .xlsx 파일에서 셀 배경색·폰트·테두리·병합 셀 등 모든 서식이 제거됩니다
- ✓ 수식 호환 불완전: VLOOKUP, INDEX/MATCH, SUMIF, 배열 수식 등 복합 Excel 수식이 정상 동작하지 않습니다
- ✓ 대용량 성능 저하: DOM 기반 렌더링 구조로 수만 행 데이터에서 스크롤 성능이 급격히 저하됩니다
- ✓ 기술 지원 없음: 공식 SLA 기반 지원이 없어 장애 발생 시 커뮤니티 검색에 의존해야 합니다
Pro 버전 — CE보다 무엇이 개선되고 무엇이 여전히 부족한가
jspreadsheet Pro는 CE의 일부 한계를 보완하지만, 엔터프라이즈 수준의 xlsx 서식 완전 보존, 피벗 테이블, 100만+ 셀 가상화 렌더링, 공식 SLA 기술 지원은 여전히 포함되지 않습니다. 특히 국내 SI 프로젝트에서 요구하는 공공 양식 기반 xlsx 정확도, 조건부 서식·차트의 xlsx 라운드트립은 Pro에서도 제한적입니다.

SpreadJS vs jspreadsheet: 기능을 항목별로 비교하면
두 라이브러리의 핵심 기능을 비교합니다. ✔는 완전 지원, △는 부분 지원, ✗는 미지원입니다.
| 기능 | jspreadsheet CE | jspreadsheet Pro | SpreadJS |
|---|---|---|---|
| 라이선스 모델 | MIT (무료) | 상용 | 상용 |
| xlsx 서식 완전 보존 | ✗ | △ | ✔ |
| Excel 호환 수식 (500+) | ✗ | △ | ✔ |
| 조건부 서식 | ✗ | △ | ✔ |
| 피벗 테이블 | ✗ | ✗ | ✔ |
| 차트 (xlsx 라운드트립) | ✗ | ✗ | ✔ |
| 가상 스크롤 (100만+ 셀) | ✗ | △ | ✔ |
| TypeScript 타입 정의 | △ | △ | ✔ |
| React / Vue / Angular 래퍼 | △ | △ | ✔ |
| 공식 SLA 기술 지원 | ✗ | ✗ | ✔ |
| 한국어 기술 지원 | ✗ | ✗ | ✔ |
gc.spread.sheets.io.min.js
)을 별도로 로드해야 합니다. 수식 엔진·조건부 서식·기본 차트는 핵심 번들에 포함되어 추가 플러그인 없이 사용 가능합니다.내 프로젝트에 맞는 라이브러리는?: 유형별 선택 체크리스트
라이브러리 선택은 현재 요건뿐 아니라 6~12개월 후 시스템 성장 방향까지 고려해야 합니다.
jspreadsheet CE를 선택하세요, 만약:
- ✓ 사내 간단한 일정 관리·재고 입력 등 소규모 팀 도구 (10인 이하)
- ✓ PoC · 해커톤 · 내부 프로토타입에서 빠른 배포가 최우선
- ✓ xlsx 서식·수식 정확도가 요건에 없고 CSV·JSON 수준으로 충분
- ✓ 라이선스 비용 없이 오픈소스로 유지해야 하는 사이드 프로젝트
SpreadJS를 선택하세요, 만약:
- ✓ ERP·SCM·그룹웨어 등 100명 이상이 사용하는 기업 정보 시스템
- ✓ 국세청·공공기관 양식처럼 xlsx 서식이 법적·업무적 정확도를 요구하는 경우
- ✓ 수만~수십만 행의 실시간 데이터(재고·수주·회계)를 브라우저에서 처리
- ✓ VLOOKUP·피벗·조건부 서식 등 Excel 수준 기능이 핵심 요건인 시스템
- ✓ 장애 발생 시 공식 SLA 지원과 한국어 기술 지원이 필요한 경우
SpreadJS로 데이터 바인딩·셀 이벤트·조건부 서식 직접 구현해보기
jspreadsheet에서 getData()
, setData()
, onchange
콜백으로 처리하던 패턴을 SpreadJS에서 어떻게 구현하는지 직접 실행해보세요. "데이터 로드" 클릭 후 합계 열에 조건부 서식(초과 달성 녹색·미달 주황)이 자동 적용되며, 셀 값을 직접 수정하면 이벤트 로그에 기록됩니다.
STEP 1: CDN 참조
STEP 2: HTML 구조
STEP 3: JavaScript
CellChanged
이벤트의 args.oldValue
/ args.newValue
로 변경 전후 값을 비교할 수 있습니다. jspreadsheet의 onchange(instance, cell, x, y, value)
콜백보다 구조화된 이벤트 객체를 제공해 복잡한 업무 로직 연결이 수월합니다.xlsx 서식을 그대로 내보내는 방법: 실행 데모와 전환 코드 패턴
SpreadJS의 IO 플러그인을 사용하면 셀 배경색·폰트·테두리·수식·시트 탭 색상까지 완전히 보존된 xlsx 파일을 생성할 수 있습니다. 아래 데모에서 "xlsx로 내보내기" 버튼을 클릭하면 서식 포함 파일이 생성됩니다.
STEP 1: CDN 참조 (IO 플러그인 추가)
STEP 2: HTML 구조
STEP 3: JavaScript
jspreadsheet 코드를 SpreadJS로 단계별로 바꾸는 방법
실제 마이그레이션에서 가장 자주 바뀌는 세 가지 패턴입니다.
① 데이터 바인딩
② 셀 변경 이벤트
③ xlsx 내보내기

개발자들이 가장 자주 묻는 질문
jspreadsheet CE와 SpreadJS 중 기업 ERP 시스템을 개발할 때 어떤 라이브러리를 써야 하나요?
기업 ERP·정산 시스템을 개발한다면 SpreadJS 선택을 권장합니다. Excel 수식 500개 이상 호환, xlsx 서식 완전 보존, 한국어 공식 기술 지원을 모두 갖추고 있습니다. jspreadsheet CE는 소규모 사내 도구나 PoC에는 적합하지만, 수식 정확도와 서식 보존이 업무 요건인 시스템에는 한계가 있습니다.
jspreadsheet로 xlsx 파일을 내보낼 때 셀 색상·테두리·병합이 그대로 유지되나요?
jspreadsheet CE와 Pro 모두 xlsx 내보내기 시 셀 배경색·폰트·테두리·병합 셀 같은 서식 정보가 손실됩니다. 공공 양식이나 정산서처럼 서식 정확도가 업무적으로 중요한 경우, SpreadJS의 IO 플러그인이 모든 서식을 그대로 보존한 xlsx 파일을 생성합니다.
무료 오픈소스 웹 스프레드시트 라이브러리를 기업 시스템에 도입하면 어떤 문제가 생기나요?
무료 오픈소스 라이브러리는 초기 개발 비용을 절감할 수 있지만, xlsx 서식 라운드트립·복잡 수식 호환·대용량 가상화·공식 SLA 기술 지원이 없어 기업 시스템 운영 단계에서 유지보수 비용이 증가합니다. '무료 라이브러리 + 자체 유지보수'의 총 비용이 상용 라이브러리 라이선스를 초과하는 경우가 많습니다.
브라우저에서 100만 행 이상 대용량 데이터를 처리할 수 있는 웹 스프레드시트 라이브러리는 무엇인가요?
SpreadJS는 100만 셀 이상의 가상화 렌더링 기능을 제공해 대용량 데이터를 다루는 기업 웹 시스템에 적합합니다. DOM 기반 렌더링 구조의 jspreadsheet CE는 수만 행에서 스크롤 성능이 급격히 저하되며, Pro 버전도 100만+ 셀 가상화를 완전히 지원하지 않습니다.
jspreadsheet 프로젝트를 SpreadJS로 마이그레이션할 때 코드를 어떻게 바꾸나요?
세 레이어를 순서대로 교체합니다. ① 데이터 바인딩( setValue
/ getValue
), ② 셀 이벤트( CellChanged
), ③ xlsx Import/Export(IO 플러그인 spread.import
/ spread.export
). 프레임워크와 함께 사용한다면 SpreadJS의 공식 React·Vue·Angular 래퍼를 활용하면 됩니다. 전환 전에 SpreadJS 30일 무료 체험판으로 기존 xlsx 파일 호환성을 먼저 검증하는 것을 추천합니다.
