SpreadJS 블로그 MESCIUS 기술 블로그 ·

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를 어떻게 교체하는지, 실무에서 바로 적용 가능한 코드 패턴으로 정리했습니다.

⭐ Key Points
이 글에서 다루는 핵심 내용
01 jspreadsheet CE 사용 한계: MIT 무료 오픈소스로 프로토타입엔 충분하지만, xlsx 서식 완전 보존·500+ 수식 엔진·100만 셀 가상화 렌더링·공식 SLA 지원이 모두 빠져 있어 기업 시스템 도입에 제약이 있습니다
02 SpreadJS(스프레드JS) by MESCIUS(메시어스): 500개 이상 Excel 호환 수식과 xlsx 서식 완전 보존 Import/Export, 100만+ 셀 가상화 렌더링을 웹 앱에 내장할 수 있는 엔터프라이즈 스프레드시트 컴포넌트입니다
03 라이브러리 선택 기준: 10인 이하 사내 도구·PoC는 jspreadsheet CE, 기업 ERP·정산·공공 보고서처럼 xlsx 정확도와 대용량 처리가 필요한 시스템은 SpreadJS를 선택하세요
04 마이그레이션 핵심 패턴: jspreadsheet에서 SpreadJS로 전환할 때 데이터 바인딩·CellChanged 이벤트·IO 플러그인 export 세 레이어를 순서대로 교체합니다
SpreadJS로 웹 엑셀 편집기 만들기: jspreadsheet 대비 차이점과 선택 기준 — 대표 이미지

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에서도 제한적입니다.

⚠ WARNING
jspreadsheet Pro는 CE보다 기능이 강화되었지만, 복잡한 xlsx 서식 라운드트립·피벗 테이블·공식 한국어 기술 지원은 포함되지 않습니다. 엔터프라이즈 도입 전 반드시 실제 사용 사례로 검증이 필요합니다.
jspreadsheet CE·Pro는 실무에서 어디서 막히는가 — SpreadJS 개념도

SpreadJS vs jspreadsheet: 기능을 항목별로 비교하면

두 라이브러리의 핵심 기능을 비교합니다. ✔는 완전 지원, △는 부분 지원, ✗는 미지원입니다.

기능 jspreadsheet CE jspreadsheet Pro SpreadJS
라이선스 모델 MIT (무료) 상용 상용
xlsx 서식 완전 보존 ✗ △ ✔
Excel 호환 수식 (500+) ✗ △ ✔
조건부 서식 ✗ △ ✔
피벗 테이블 ✗ ✗ ✔
차트 (xlsx 라운드트립) ✗ ✗ ✔
가상 스크롤 (100만+ 셀) ✗ △ ✔
TypeScript 타입 정의 △ △ ✔
React / Vue / Angular 래퍼 △ △ ✔
공식 SLA 기술 지원 ✗ ✗ ✔
한국어 기술 지원 ✗ ✗ ✔
↗
500+
내장 수식
Excel 호환 계산 엔진
↗
100만+
셀 가상화
대용량 렌더링 지원
↗
3,500+
글로벌 기업
SpreadJS 도입 레퍼런스
ⓘ NOTE
SpreadJS의 xlsx Import/Export는 IO 플러그인( gc.spread.sheets.io.min.js )을 별도로 로드해야 합니다. 수식 엔진·조건부 서식·기본 차트는 핵심 번들에 포함되어 추가 플러그인 없이 사용 가능합니다.

내 프로젝트에 맞는 라이브러리는?: 유형별 선택 체크리스트

라이브러리 선택은 현재 요건뿐 아니라 6~12개월 후 시스템 성장 방향까지 고려해야 합니다.

jspreadsheet CE를 선택하세요, 만약:

  • ✓ 사내 간단한 일정 관리·재고 입력 등 소규모 팀 도구 (10인 이하)
  • ✓ PoC · 해커톤 · 내부 프로토타입에서 빠른 배포가 최우선
  • ✓ xlsx 서식·수식 정확도가 요건에 없고 CSV·JSON 수준으로 충분
  • ✓ 라이선스 비용 없이 오픈소스로 유지해야 하는 사이드 프로젝트

SpreadJS를 선택하세요, 만약:

  • ✓ ERP·SCM·그룹웨어 등 100명 이상이 사용하는 기업 정보 시스템
  • ✓ 국세청·공공기관 양식처럼 xlsx 서식이 법적·업무적 정확도를 요구하는 경우
  • ✓ 수만~수십만 행의 실시간 데이터(재고·수주·회계)를 브라우저에서 처리
  • ✓ VLOOKUP·피벗·조건부 서식 등 Excel 수준 기능이 핵심 요건인 시스템
  • ✓ 장애 발생 시 공식 SLA 지원과 한국어 기술 지원이 필요한 경우
⭐ IMPORTANT
"일단 무료로 시작하고 나중에 교체하자"는 전략은 주의가 필요합니다. 데이터 모델·이벤트 핸들러·서식 로직이 라이브러리에 깊이 결합된 뒤 마이그레이션 비용이 초기 라이선스 비용보다 훨씬 커지는 경우가 많습니다. 엔터프라이즈 요건이 예상된다면 초기부터 적합한 라이브러리를 선택하는 것이 현명합니다.

SpreadJS로 데이터 바인딩·셀 이벤트·조건부 서식 직접 구현해보기

jspreadsheet에서 getData() , setData() , onchange 콜백으로 처리하던 패턴을 SpreadJS에서 어떻게 구현하는지 직접 실행해보세요. "데이터 로드" 클릭 후 합계 열에 조건부 서식(초과 달성 녹색·미달 주황)이 자동 적용되며, 셀 값을 직접 수정하면 이벤트 로그에 기록됩니다.

STEP 1: CDN 참조

STEP 2: HTML 구조

STEP 3: JavaScript

실행 결과
💡 TIP
SpreadJS 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

실행 결과
ⓘ NOTE
jspreadsheet의 xlsx 내보내기는 원시 데이터만 출력해 서식이 모두 사라집니다. SpreadJS는 IO 플러그인이 서버 없이 클라이언트 측에서 완전한 xlsx를 생성하며, 셀 색상·병합·수식·시트 탭 색상이 Excel에서도 동일하게 표시됩니다.

jspreadsheet 코드를 SpreadJS로 단계별로 바꾸는 방법

실제 마이그레이션에서 가장 자주 바뀌는 세 가지 패턴입니다.

① 데이터 바인딩

② 셀 변경 이벤트

③ xlsx 내보내기

xlsx 서식을 그대로 내보내는 방법: 실행 데모와 전환 코드 패턴 — SpreadJS 개념도
⭐ BEST PRACTICE
마이그레이션 시 데이터 바인딩·이벤트·IO 세 레이어를 순서대로 교체하면 기존 업무 로직을 최대한 재활용할 수 있습니다. SpreadJS는 jspreadsheet와 API 설계 철학이 달라 1:1 변환보다는 레이어별 재설계가 결과 품질을 높입니다.

개발자들이 가장 자주 묻는 질문

Q01

jspreadsheet CE와 SpreadJS 중 기업 ERP 시스템을 개발할 때 어떤 라이브러리를 써야 하나요?

기업 ERP·정산 시스템을 개발한다면 SpreadJS 선택을 권장합니다. Excel 수식 500개 이상 호환, xlsx 서식 완전 보존, 한국어 공식 기술 지원을 모두 갖추고 있습니다. jspreadsheet CE는 소규모 사내 도구나 PoC에는 적합하지만, 수식 정확도와 서식 보존이 업무 요건인 시스템에는 한계가 있습니다.

Q02

jspreadsheet로 xlsx 파일을 내보낼 때 셀 색상·테두리·병합이 그대로 유지되나요?

jspreadsheet CE와 Pro 모두 xlsx 내보내기 시 셀 배경색·폰트·테두리·병합 셀 같은 서식 정보가 손실됩니다. 공공 양식이나 정산서처럼 서식 정확도가 업무적으로 중요한 경우, SpreadJS의 IO 플러그인이 모든 서식을 그대로 보존한 xlsx 파일을 생성합니다.

Q03

무료 오픈소스 웹 스프레드시트 라이브러리를 기업 시스템에 도입하면 어떤 문제가 생기나요?

무료 오픈소스 라이브러리는 초기 개발 비용을 절감할 수 있지만, xlsx 서식 라운드트립·복잡 수식 호환·대용량 가상화·공식 SLA 기술 지원이 없어 기업 시스템 운영 단계에서 유지보수 비용이 증가합니다. '무료 라이브러리 + 자체 유지보수'의 총 비용이 상용 라이브러리 라이선스를 초과하는 경우가 많습니다.

Q04

브라우저에서 100만 행 이상 대용량 데이터를 처리할 수 있는 웹 스프레드시트 라이브러리는 무엇인가요?

SpreadJS는 100만 셀 이상의 가상화 렌더링 기능을 제공해 대용량 데이터를 다루는 기업 웹 시스템에 적합합니다. DOM 기반 렌더링 구조의 jspreadsheet CE는 수만 행에서 스크롤 성능이 급격히 저하되며, Pro 버전도 100만+ 셀 가상화를 완전히 지원하지 않습니다.

Q05

jspreadsheet 프로젝트를 SpreadJS로 마이그레이션할 때 코드를 어떻게 바꾸나요?

세 레이어를 순서대로 교체합니다. ① 데이터 바인딩( setValue / getValue ), ② 셀 이벤트( CellChanged ), ③ xlsx Import/Export(IO 플러그인 spread.import / spread.export ). 프레임워크와 함께 사용한다면 SpreadJS의 공식 React·Vue·Angular 래퍼를 활용하면 됩니다. 전환 전에 SpreadJS 30일 무료 체험판으로 기존 xlsx 파일 호환성을 먼저 검증하는 것을 추천합니다.

MESCIUS SpreadJS

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

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

SpreadJS 무료 체험판 다운로드