SpreadJS로 JavaScript 웹 앱에 Excel 수식·xlsx 기능 구현하기
웹 프론트엔드 개발자가 "웹에서 엑셀 기능을 구현해야 한다"는 요구를 받으면, 가장 먼저 가볍고 무료인 데이터 그리드 라이브러리를 떠올립니다. SpreadJS는 MESCIUS가 개발한 JavaScript 기반 엔터프라이즈 스프레드시트 컴포넌트로, 500개 이상의 Excel 호환 수식 엔진과 xlsx 서식 보존 가져오기/내보내기를 서버 없이 브라우저 안에서 직접 처리합니다.
React·Vue·Angular 프로젝트에서 목록 조회나 단순 인라인 편집만 필요하다면 Tabulator 같은 경량 오픈소스 그리드로도 충분합니다. 그러나 사용자가 Excel 파일을 업로드하거나, SUM·VLOOKUP이 포함된 보고서를 웹에서 직접 편집해야 하는 순간, 데이터 그리드와 스프레드시트 컴포넌트 사이의 설계 범위 차이가 명확하게 드러납니다.
이 글에서는 조건부 서식·xlsx I/O·피벗 테이블 등 실제 개발 시나리오로 Tabulator와 SpreadJS를 비교하고, Tabulator 기반 데이터 바인딩·이벤트 코드를 SpreadJS API로 전환하는 마이그레이션 패턴을 실코드와 함께 살펴봅니다.

Tabulator란 무엇인가: 경량 데이터 그리드가 Excel을 대체할 수 없는 이유
Tabulator는 의존성 없이 단 몇 줄로 데이터 테이블을 렌더링할 수 있어 빠른 프로토타이핑과 단순 CRUD 시나리오에 강합니다.
Tabulator가 빛나는 시나리오는 명확합니다. 관리자 페이지의 목록 조회, 인라인 셀 직접 편집 후 서버 PUT 요청, 정렬·페이징·컬럼 리사이징 같은 기본 그리드 UX가 여기에 해당합니다. 이런 목적에서는 설치 없이 무료로 쓸 수 있는 Tabulator가 합리적인 선택입니다.
그러나 Tabulator의 설계 범위는 Excel 수준 기능을 구현하기 어렵습니다.
- ✓
수식 엔진 없음:
=SUM(),=VLOOKUP()같은 Excel 함수를 셀에서 직접 계산하는 기능이 없습니다. 참조 관계가 복잡해질수록 JavaScript 수동 계산 로직의 유지보수 비용이 급격히 높아집니다. - ✓ xlsx 서식 유실: Tabulator는 xlsx를 완전히 가져오거나 내보낼 수 없습니다. SheetJS 같은 외부 라이브러리를 조합해도 셀 병합, 조건부 서식, 수식은 대부분 손실됩니다.
- ✓ 피벗·차트 미지원: 기본 집계 뷰와 내장 차트를 제공하지 않으며, 별도 차트 라이브러리와의 데이터 동기화를 직접 구현해야 합니다.
웹 앱에서 Excel 조건부 서식을 구현하는 방법
Excel에서 "목표 미달 셀은 빨간색, 달성은 녹색"과 같은 조건부 서식은 기획자·회계담당자에게 필수 UX입니다. Tabulator에서는 formatter
콜백으로 DOM 스타일을 JavaScript로 직접 제어해야 하고, 수식 참조 관계가 생기면 로직이 급격히 복잡해집니다.
SpreadJS는 addCellValueRule()
로 이 로직을 선언적으로 표현합니다. 값이 바뀔 때마다 자동으로 재평가되어 별도의 redraw()
호출이 필요 없습니다.
STEP 1: CDN 참조
STEP 2: HTML 구조
STEP 3: JavaScript — SUM 수식 + 조건부 서식
addCellValueRule()
의 조건부 서식 규칙은 선언만 해두면 셀 값이 변경될 때마다 자동으로 재평가됩니다. Tabulator의 formatter
방식처럼 DOM을 매번 수동으로 조작할 필요가 없습니다.formatter
방식은 서버에서 받은 xlsx 파일에는 적용되지 않습니다. xlsx를 가져온 뒤에도 같은 색상 로직을 유지하려면 SpreadJS처럼 xlsx 레벨의 조건부 서식이 필요합니다.SpreadJS로 xlsx 파일을 서식 그대로 가져오고 내보내는 방법
SpreadJS는 500개 이상의 Excel 호환 함수와 함께 xlsx 파일을 서버 없이 브라우저에서 직접 가져오고 내보냅니다. 셀 병합, 조건부 서식, 차트, 수식 참조까지 보존됩니다.
STEP 1: CDN (IO 플러그인 추가)
STEP 2: HTML 구조
STEP 3: JavaScript
spread.import()
와 spread.export()
는 서버 왕복 없이 브라우저에서 직접 처리합니다.
데이터 그리드와 스프레드시트 컴포넌트, 어떤 기준으로 선택해야 할까?
두 라이브러리의 기술적 차이를 아래 표로 한눈에 비교할 수 있습니다.
| 기능 | Tabulator | SpreadJS |
|---|---|---|
| 수식 엔진 (SUM·VLOOKUP 등) | ✗ | ✓ (500개+) |
| xlsx 가져오기/내보내기 | △ 외부 라이브러리 | ✓ 서식·수식 완전 보존 |
| 가상화 렌더링 (100만+ 셀) | ✗ | ✓ |
| 조건부 서식 | △ JS 수동 구현 | ✓ 선언적 API |
| 피벗 테이블 | ✗ | ✓ |
| 차트 | ✗ | ✓ |
| React/Vue/Angular 공식 래퍼 | ✗ | ✓ |
| 라이선스 | MIT (오픈소스) | 상용 (30일 무료 체험) |
| 기술 지원 | 커뮤니티 | MESCIUS 공식 지원 |
Excel 수식·서식 보존·피벗·차트가 필요한 ERP·회계·보고서 → SpreadJS

Tabulator 코드를 SpreadJS로 마이그레이션하는 방법
Tabulator와 SpreadJS는 개념은 유사하지만 API가 다릅니다. 아래 대응 패턴을 참고하면 전환 비용을 최소화할 수 있습니다.
데이터 로딩 비교
아래는 JSON 배열을 SpreadJS로 바인딩하고 셀 변경 이벤트를 처리하는 완성 예시입니다.
STEP 2: HTML 구조
STEP 3: JavaScript
| Tabulator | SpreadJS |
|---|---|
table.setData(data)
|
sheet.setArray(row, col, data)
|
table.getData()
|
sheet.getArray(row, col, rowCount, colCount)
|
table.on('cellEdited', cb)
|
sheet.bind(Events.CellChanged, cb)
|
table.on('rowAdded', cb)
|
sheet.bind(Events.RowChanged, cb)
|
formatter: 'money'
|
sheet.getCell(r,c).formatter('#,##0')
|
SpreadJS vs 데이터 그리드: 개발자 자주 묻는 질문
Tabulator와 SpreadJS는 어떻게 다른가요?
Tabulator는 수식 계산 엔진과 xlsx 완전 호환 기능 없이 그리드 렌더링에 집중한 경량 라이브러리이고, SpreadJS는 500개 이상의 Excel 호환 함수와 xlsx 서식 보존 가져오기/내보내기를 모두 지원하는 엔터프라이즈 스프레드시트 컴포넌트입니다.
웹 프로젝트에서 데이터 그리드와 스프레드시트 컴포넌트 중 어떤 것을 선택해야 하나요?
목록 조회나 인라인 편집 위주의 단순 CRUD라면 Tabulator를, 수식·Excel 서식 보존·피벗·차트가 필요한 ERP·회계·보고서 시스템을 개발한다면 SpreadJS를 선택하는 것이 적합합니다.
Tabulator에서 Excel 수식(SUM, VLOOKUP 등)을 사용할 수 있나요?
Tabulator에는 수식 계산 엔진이 내장되어 있지 않아 SUM·VLOOKUP 같은 Excel 함수를 셀에서 직접 실행할 수 없습니다. JavaScript로 별도 계산 로직을 작성해야 하며, 셀 간 참조 관계가 복잡해질수록 유지보수 비용이 크게 늘어납니다.
웹 앱에서 Excel 파일의 서식을 그대로 유지하면서 가져오고 내보내려면 어떤 라이브러리를 써야 하나요?
SpreadJS는 500개 이상의 Excel 호환 수식과 xlsx 서식 보존 가져오기/내보내기를 지원해, 셀 병합·조건부 서식·수식 참조까지 유실 없이 브라우저에서 Excel 파일을 처리할 수 있습니다.
언제 오픈소스 데이터 그리드 대신 상용 스프레드시트 컴포넌트를 사용해야 하나요?
사용자가 Excel 파일을 직접 업로드·다운로드하거나, 수식이 포함된 보고서를 웹 에디터에서 직접 편집해야 하는 시나리오라면 Tabulator 같은 순수 그리드로는 요구사항 충족이 어렵고 SpreadJS가 더 적합한 선택입니다.
