SpreadJS TableSheet로 REST API 데이터 그리드와 CRUD 구현하기
SpreadJS는 MESCIUS가 개발한 JavaScript 스프레드시트 라이브러리로, 웹 애플리케이션에 엑셀 수준의 데이터 그리드와 CRUD 기능을 순수 프론트엔드 코드만으로 구현할 수 있게 해줍니다. 그 중에서도 TableSheet는 DataManager와 결합해 REST API 데이터를 직접 연결하고, 별도의 Ajax 코드 없이 자동 집계·필터·정렬을 처리하는 구조화 데이터 전용 시트 타입입니다.
React·Vue·Angular 또는 Vanilla JS로 웹 앱을 개발하다 보면, 서버 API 데이터를 그리드에 표시하면서 행 추가·수정·삭제를 함께 처리해야 하는 상황이 자주 생깁니다. fetch()
로 데이터를 불러와 테이블에 바인딩하고 편집 이벤트를 감지해 다시 API를 호출하는 코드를 붙이다 보면, 어느새 수백 줄의 보일러플레이트가 쌓이게 됩니다.
이 가이드는 SpreadJS TableSheet와 DataManager를 조합해 REST API 연결·자동 CRUD 동기화·집계 행·내장 필터를 최소한의 코드로 구현하는 방법을 단계별로 안내합니다. ERP·재고·인사 시스템 개발을 처음 시작하는 프론트엔드 개발자라면, 이 패턴 하나로 반복되는 그리드 개발 공수를 대폭 줄일 수 있습니다.
groupBy()
+ summaryFields
로 SUM·AVERAGE·COUNT 집계 행 자동 생성
autoSync: true
옵션 하나로 서버 실시간 동기화

TableSheet와 Worksheet 중 어느 것을 선택해야 할까?
TableSheet는 DataManager와 결합해 자동 CRUD·집계 행·내장 필터를 제공하는 구조화 데이터 전용 시트로, 일반 Worksheet보다 DB 연동 UI 구현이 훨씬 빠릅니다.
| 항목 | Worksheet | TableSheet |
|---|---|---|
| 데이터 바인딩 | 셀 직접 setValue | DataManager View 바인딩 |
| CRUD 서버 동기화 | 직접 Ajax 코드 작성 | autoSync: true
한 줄 |
| 정렬·필터 | 별도 API 설정 필요 | 헤더 드롭다운 내장 |
| 집계 행 | 수식 셀 직접 추가 | groupBy()
+ summaryFields
|
| 대용량 데이터 | 전체 렌더링 | 가상 스크롤 내장 |
| 적합한 케이스 | 자유 형식 스프레드시트 | 구조화된 마스터 데이터 관리 |
gc.spread.sheets.tablesheet.x.x.x.min.js
플러그인을 별도로 로드해야 합니다. DataManager는 코어 라이브러리에 포함됩니다.
DataManager와 TableSheet를 5단계로 연결하는 방법
DataManager와 TableSheet를 연결하는 전체 흐름은 5단계입니다.
STEP 1: CDN 로드 (TableSheet 플러그인 추가 필수)
STEP 2: HTML 구조
STEP 3: JavaScript — DataManager 5단계 연결
data: [...]
대신 remote: { read: { url: '...' }, create: {...}, update: {...}, delete: {...} }
옵션으로 교체하고 autoSync: true
를 추가하면, 셀 편집이 자동으로 서버에 동기화됩니다. 별도 저장 버튼 없이 실시간 CRUD가 완성됩니다.groupBy + summaryFields로 자동 집계 행을 구현하는 방법
TableSheet의 집계는 sheet.groupBy()
와 summaryFields
배열로 정의합니다. 수식 문자열 =SUM([필드명])
형태로 SUM·AVERAGE·COUNT·MIN·MAX를 자유롭게 조합할 수 있습니다.
STEP 1: CDN
STEP 2: HTML
STEP 3: JavaScript — 지역별 매출 집계 데모
summaryFields
의 formula
는 =SUM([필드명])
형식에서 대괄호 []
안에 DataManager 필드명(value 속성 값)을 정확히 입력해야 합니다. 열 캡션(caption)이 아닌 원본 필드 키를 사용합니다.

외부 라이브러리 없이 컬럼 필터·정렬·그룹핑을 사용하는 방법
TableSheet는 헤더 영역에 드롭다운 필터와 정렬 버튼이 내장되어 있습니다. 사용자가 헤더를 클릭하면 즉시 정렬이 적용되고, 헤더 아이콘을 클릭하면 값 필터 패널이 열립니다. 코드로도 그룹핑 상태를 제어할 수 있습니다.
groupBy()
옵션 객체에 allowSort: false
, allowFilterByValue: false
, allowFilterByList: false
를 추가하면 그룹 열의 정렬·필터를 개별적으로 제한할 수 있어 읽기 전용 집계 열을 만들 수 있습니다.SpreadJS TableSheet로 재고 관리 시스템을 직접 만들어보기
카테고리별 재고 합계와 평균 단가를 자동 집계하는 재고 마스터 데모입니다. 실무에서는 autoSync: true
와 REST API를 연결하면 품목 추가·수정·삭제가 즉시 백엔드에 반영됩니다.
STEP 1: CDN
STEP 2: HTML
STEP 3: JavaScript
formula: '=COUNTIF([stock],"<10")'
수식을 추가하세요. 카테고리별 부족 품목 수를 즉시 파악할 수 있습니다. 실제 임계값은 [reorder]
필드를 기준으로 동적 조건을 설정하는 것이 좋습니다.SpreadJS TableSheet 개발자 FAQ: 자주 묻는 질문
TableSheet와 일반 Worksheet는 어떻게 다른가요? 어떤 상황에서 TableSheet를 선택해야 할까요?
SpreadJS TableSheet는 DataManager와 결합해 자동 CRUD·집계 행·내장 필터를 제공하는 구조화 데이터 전용 시트 타입으로, 마스터 데이터 관리나 목록 화면처럼 테이블 형태의 데이터를 다룰 때 적합합니다. 반면 자유로운 셀 배치가 필요한 보고서 양식에는 일반 Worksheet를 사용하는 것이 맞습니다.
SpreadJS에서 REST API 데이터를 화면에 표시하고 행 추가·수정·삭제를 자동으로 처리하려면 어떻게 하나요?
DataManager의 addTable()
로 REST API를 DataConnector에 등록하고, remote
옵션에 read/create/update/delete URL을 각각 지정합니다. autoSync: true
를 추가하면 셀을 편집할 때마다 서버 API가 자동 호출되어 별도 저장 버튼 없이 실시간 CRUD가 완성됩니다.
JavaScript 그리드에서 그룹별 합계·평균·개수를 자동으로 집계하는 행을 추가하려면 어떻게 하나요?
sheet.groupBy()
메서드의 summaryFields
배열에 formula: '=SUM([fieldName])'
형식으로 집계 수식을 정의하면 그룹마다 집계 행이 자동으로 생성됩니다. SUM·AVERAGE·COUNT·MIN·MAX를 자유롭게 조합할 수 있고, 별도 수식 셀이나 추가 라이브러리가 필요 없습니다.
서버사이드 페이징·정렬·필터를 지원하는 JavaScript 데이터 그리드 라이브러리가 있나요?
SpreadJS DataManager는 OData 프로토콜을 기본 지원하므로, 서버사이드 처리를 활성화하면 $filter
, $orderby
, $skip
, $top
파라미터가 REST 요청에 자동으로 추가됩니다. 클라이언트 내장 필터·정렬과 서버사이드 처리를 함께 사용할 수 있어 대용량 데이터 그리드 구현에 유리합니다.
SpreadJS TableSheet를 사용해 웹 기반 재고 관리 화면을 만들 수 있나요?
가능합니다. TableSheet와 DataManager 조합으로 품목 CRUD, 창고별 재고 현황, 카테고리별 SUM·AVERAGE 집계, 재주문점 이하 품목 필터링을 모두 구현할 수 있습니다. ERP·WMS 백엔드 REST API에 autoSync: true
로 연결하면 셀 편집 즉시 서버에 반영됩니다.
