JavaScript 웹 스프레드시트 비교: x-spreadsheet에서 SpreadJS로 전환하기
웹 애플리케이션에 'Excel처럼 동작하는 그리드'가 필요할 때, 선택지는 크게 두 가지입니다. GitHub에서 MIT 라이선스로 무료로 사용할 수 있는 x-spreadsheet, 그리고 엔터프라이즈 기능을 갖춘 상용 라이브러리 SpreadJS입니다. SpreadJS는 MESCIUS가 개발한 JavaScript 스프레드시트 컴포넌트로, 500개 이상의 Excel 호환 수식 엔진, xlsx 서식 보존 Import/Export, 100만 셀 이상의 가상화 렌더링을 하나의 패키지로 제공합니다.
많은 개발자가 프로토타입 단계에서 x-spreadsheet를 선택합니다. 설치가 간단하고 번들 크기가 작아 로딩 속도에 민감한 서비스에서도 쓸 수 있기 때문입니다. npm 한 줄로 설치한 뒤 최소한의 설정만 추가하면 셀 편집 화면을 바로 올릴 수 있습니다.
그런데 프로토타입이 끝나고 실제 요구사항이 붙기 시작하면 상황이 달라집니다. '합계를 자동으로 계산해야 해요', '기존 엑셀 파일을 서식 그대로 불러와야 해요', '데이터가 수십만 건인데 느리면 안 돼요' — 이 요구사항들은 x-spreadsheet가 구조적으로 지원하지 않는 영역에 정확히 걸쳐 있습니다.
이 글에서는 x-spreadsheet의 구조적 한계를 실무 시나리오 기준으로 살펴보고, SpreadJS가 각 항목을 어떻게 해결하는지 비교합니다. 나아가 x-spreadsheet JSON 데이터를 SpreadJS API로 옮기는 실전 마이그레이션 코드 패턴도 함께 다룹니다.

x-spreadsheet란 무엇인가? 기능과 사용 사례 한눈에 보기
x-spreadsheet(공식 패키지명 x-data-spreadsheet
)는 2018년 공개된 MIT 라이선스 웹 스프레드시트 라이브러리로, 캔버스 기반 렌더링으로 DOM 오버헤드 없이 빠른 초기 로딩을 제공합니다.
주요 특징은 간결합니다. 셀 편집, 기본 스타일(굵게·색상·정렬), 병합 셀, 컨텍스트 메뉴 — 단순한 데이터 입력 화면이라면 충분합니다. npm 설치와 CDN 포함 모두 가능하고, 번들 크기가 작아 로딩 속도에 민감한 서비스에서 선호되기도 합니다.

x-spreadsheet를 실무에 적용하면 어떤 문제가 발생하나요?
1. 수식 계산이 왜 작동하지 않는 걸까요?
x-spreadsheet는 =SUM(A1:A10)
같은 수식을 자체적으로 계산하지 않습니다. 셀에 문자열로 저장될 뿐입니다. 수식 계산을 구현하려면 HyperFormula 같은 별도 수식 엔진을 직접 연동·동기화해야 하며, ERP·정산 시스템에서는 사실상 사용 불가 수준의 한계입니다.
2. xlsx 파일을 열었을 때 서식이 깨지는 이유는?
Excel 파일(.xlsx)을 불러올 때 x-spreadsheet는 SheetJS와 연동하더라도 셀 색상, 테두리, 조건부 서식, 병합 정보 등 서식 정보 대부분을 잃습니다. "엑셀에서 열리는 것처럼 보여줘야 한다"는 요구사항이 생기는 순간 한계가 드러납니다.
3. 데이터가 많아지면 렌더링이 느려지는 원인은?
x-spreadsheet는 가상화(virtualized rendering)를 구현하지 않습니다. 10만 행 이상의 데이터를 로드하면 브라우저가 멈추거나 초기 렌더링이 수초 이상 지연됩니다. 재고 조회·로그 분석처럼 대용량 그리드가 필요한 실무 화면에서 성능이 보장되지 않습니다.
4. 기업 시스템에 필요한 기능이 없다면 어떻게 해야 하나요?
피벗 테이블, 차트, 조건부 서식, 데이터 유효성 검사, 인쇄/PDF 내보내기 — 기업 시스템에서 요청받는 기능 대부분이 x-spreadsheet에는 없습니다. 직접 구현하거나 라이브러리를 교체해야 합니다.
SpreadJS는 무엇이 다른가? 엔터프라이즈 스프레드시트 기능 비교표
SpreadJS는 Excel 호환 수식 함수 500개 이상을 내장한 수식 엔진, xlsx 파일의 서식을 보존한 채 Import/Export하는 IO 플러그인, 100만 셀 이상의 가상화 렌더링을 하나의 패키지로 제공합니다.

| 기능 | x-spreadsheet | SpreadJS |
|---|---|---|
| 수식 엔진 | ✗ | ✓ (500+ 함수) |
| xlsx Import/Export (서식 보존) | ✗ | ✓ |
| 가상화 렌더링 (100만+ 셀) | ✗ | ✓ |
| 조건부 서식 | ✗ | ✓ |
| 피벗 테이블 | ✗ | ✓ |
| 차트 | ✗ | ✓ |
| 인쇄 / PDF 내보내기 | ✗ | ✓ |
| 기술지원 / SLA | 커뮤니티만 | ✓ |
| 라이선스 | MIT (무료) | 상용 |
아래 데모에서 SpreadJS의 수식 엔진과 조건부 서식이 실제로 작동하는 모습을 확인할 수 있습니다. =SUM()
, =AVERAGE()
, =IF(MAX(...))
수식이 자동 계산되고, 합계 값에 따라 셀 색상이 조건부로 적용됩니다.
STEP 1: 라이브러리 참조 (CDN)
STEP 2: HTML 구조
STEP 3: 수식 엔진 + 조건부 서식 데모
=SUM(B2:D2)
를 셀에 입력해도 숫자가 계산되지 않습니다. 수식 엔진이 없기 때문입니다. SpreadJS는 수식 엔진을 내장하므로 Excel과 동일한 방식으로 수식이 실시간 자동 계산됩니다.x-spreadsheet 데이터를 SpreadJS API로 마이그레이션하는 방법
x-spreadsheet는 데이터를 다음과 같은 JSON 구조로 저장합니다. 행(row) 인덱스를 키로, 그 안에 셀(cell) 인덱스와 텍스트 값이 중첩된 형태입니다.
이 데이터를 SpreadJS로 마이그레이션할 때는 Object.entries()
로 행·셀 인덱스를 순회하면서 sheet.setValue()
를 호출합니다. 텍스트로 저장된 숫자는 parseFloat()
로 변환하고, 수식은 sheet.setFormula()
로 별도 설정합니다.
STEP 1: 라이브러리 참조 (CDN)
STEP 2: HTML 구조
STEP 3: x-spreadsheet JSON → SpreadJS 마이그레이션 패턴
text
)로 저장합니다. SpreadJS에서 수식 계산이 정상 작동하려면 반드시 parseFloat()
로 변환 후 숫자 타입으로 setValue()
에 전달해야 합니다.아래 표는 x-spreadsheet API와 SpreadJS API의 주요 대응표입니다.
| x-spreadsheet | SpreadJS |
|---|---|
xs.loadData(rows)
|
migrateFromXSpread(xsData, sheet)
함수로 변환 |
rows[r].cells[c].text = '값'
|
sheet.setValue(r, c, value)
|
rows[r].cells[c].style.bgcolor
|
sheet.getCell(r, c).backColor('#color')
|
rows[r].cells[c].style.bold
|
sheet.getCell(r, c).font('bold 12px sans-serif')
|
| 수식 미지원 | sheet.setFormula(r, c, '=SUM(A1:A10)')
|
| merge 배열 | sheet.addSpan(r, c, rowCount, colCount)
|
라이선스와 기술지원은 어떻게 다른가요?
x-spreadsheet는 MIT 라이선스로 무료입니다. 단, 기술지원은 커뮤니티(GitHub Issues)만 존재하며 응답 보장이 없고, 2022년 이후 실질적인 업데이트도 중단 상태입니다.
SpreadJS는 상용 라이선스로 운영됩니다. MESCIUS(메시어스)는 기술지원팀과 SLA를 제공하며, 브라우저 호환성·보안 업데이트·기능 개선이 정기적으로 이루어집니다. 30일 무료 체험 후 라이선스를 구매하는 방식이며, 기업 시스템의 유지보수 리스크를 구조적으로 낮춥니다.
자주 하는 질문
SpreadJS와 x-spreadsheet의 가장 큰 차이가 무엇인가요?
x-spreadsheet는 수식 계산과 xlsx 서식 보존 기능이 없는 경량 편집 뷰어인 반면, SpreadJS는 500+ 수식·서식 보존 Import/Export를 갖춘 엔터프라이즈 스프레드시트 컴포넌트입니다.
실무 ERP나 그룹웨어 시스템에 x-spreadsheet를 사용해도 될까요?
피벗 테이블, 차트, 조건부 서식, 대용량 데이터 처리가 필요한 시스템이라면 x-spreadsheet는 한계에 부딪히며, SpreadJS가 실무 ERP에 적합한 대안입니다.
웹에서 수식을 계산할 수 있는 오픈소스 스프레드시트 라이브러리가 있나요?
x-spreadsheet는 수식 엔진을 내장하지 않으며, Luckysheet·Handsontable도 수식 계산을 위해 HyperFormula를 별도로 연동해야 합니다. SpreadJS는 500개 이상의 수식을 별도 설정 없이 내장 엔진으로 즉시 제공합니다.
x-spreadsheet로 기존 Excel 파일을 열면 서식이 보존되나요?
불가능합니다. SheetJS를 추가 연동해도 셀 색상·테두리·조건부 서식 같은 서식 정보는 대부분 손실됩니다. SpreadJS의 IO 플러그인은 xlsx 서식을 보존한 채 Import/Export합니다.
오픈소스 웹 엑셀 라이브러리에서 상용 제품으로 전환해야 하는 시점은 언제인가요?
수식 계산, xlsx 서식 보존, 10만 행 이상의 성능, 피벗·차트·PDF 내보내기 가운데 하나라도 프로젝트 요구사항에 포함된다면 상용 컴포넌트로의 전환 시점입니다. POC 이후 요구사항이 확장될 때 전환 비용이 가장 낮습니다.
