SpreadJS 블로그 MESCIUS 기술 블로그 ·

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·재고·인사 시스템 개발을 처음 시작하는 프론트엔드 개발자라면, 이 패턴 하나로 반복되는 그리드 개발 공수를 대폭 줄일 수 있습니다.

⭐ Key Points
이 글에서 다루는 핵심 내용
01 TableSheet + DataManager: DataConnector로 REST API를 연결하면 별도 Ajax 코드 없이 엑셀 감각의 CRUD 그리드를 완성할 수 있음
02 집계·필터·정렬 내장: 외부 라이브러리 없이 groupBy() + summaryFields 로 SUM·AVERAGE·COUNT 집계 행 자동 생성
03 다중 프로토콜 지원: REST·OData·GraphQL DataConnector 기본 내장 — autoSync: true 옵션 하나로 서버 실시간 동기화
04 실무 시나리오 바로 적용: 재고 마스터·인사 대장·프로젝트 이슈 트래커 등 엔터프라이즈 UI에 즉시 활용 가능
SpreadJS TableSheet로 REST API 데이터 그리드와 CRUD 구현하기 — 대표 이미지

TableSheet와 Worksheet 중 어느 것을 선택해야 할까?

TableSheet는 DataManager와 결합해 자동 CRUD·집계 행·내장 필터를 제공하는 구조화 데이터 전용 시트로, 일반 Worksheet보다 DB 연동 UI 구현이 훨씬 빠릅니다.

항목 Worksheet TableSheet
데이터 바인딩 셀 직접 setValue DataManager View 바인딩
CRUD 서버 동기화 직접 Ajax 코드 작성 autoSync: true 한 줄
정렬·필터 별도 API 설정 필요 헤더 드롭다운 내장
집계 행 수식 셀 직접 추가 groupBy() + summaryFields
대용량 데이터 전체 렌더링 가상 스크롤 내장
적합한 케이스 자유 형식 스프레드시트 구조화된 마스터 데이터 관리
ⓘ NOTE
TableSheet는 gc.spread.sheets.tablesheet.x.x.x.min.js 플러그인을 별도로 로드해야 합니다. DataManager는 코어 라이브러리에 포함됩니다.
TableSheet와 Worksheet 중 어느 것을 선택해야 할까? — SpreadJS 개념도

DataManager와 TableSheet를 5단계로 연결하는 방법

DataManager와 TableSheet를 연결하는 전체 흐름은 5단계입니다.

STEP 1: CDN 로드 (TableSheet 플러그인 추가 필수)

STEP 2: HTML 구조

STEP 3: JavaScript — DataManager 5단계 연결

실행 결과
💡 TIP
REST API 연동 시에는 data: [...] 대신 remote: { read: { url: '...' }, create: {...}, update: {...}, delete: {...} } 옵션으로 교체하고 autoSync: true 를 추가하면, 셀 편집이 자동으로 서버에 동기화됩니다. 별도 저장 버튼 없이 실시간 CRUD가 완성됩니다.
↗
REST·OData·GraphQL
DataConnector 지원 프로토콜
DataManager 공식 문서 기준
↗
500+
Excel 호환 수식
집계 행 formula에서 활용 가능
↗
autoSync: true
서버 CRUD 동기화
별도 Ajax 코드 불필요

groupBy + summaryFields로 자동 집계 행을 구현하는 방법

TableSheet의 집계는 sheet.groupBy() 와 summaryFields 배열로 정의합니다. 수식 문자열 =SUM([필드명]) 형태로 SUM·AVERAGE·COUNT·MIN·MAX를 자유롭게 조합할 수 있습니다.

STEP 1: CDN

STEP 2: HTML

STEP 3: JavaScript — 지역별 매출 집계 데모

실행 결과
⭐ IMPORTANT
summaryFields 의 formula 는 =SUM([필드명]) 형식에서 대괄호 [] 안에 DataManager 필드명(value 속성 값)을 정확히 입력해야 합니다. 열 캡션(caption)이 아닌 원본 필드 키를 사용합니다.
groupBy + summaryFields로 자동 집계 행을 구현하는 방법 — SpreadJS 개념도

외부 라이브러리 없이 컬럼 필터·정렬·그룹핑을 사용하는 방법

TableSheet는 헤더 영역에 드롭다운 필터와 정렬 버튼이 내장되어 있습니다. 사용자가 헤더를 클릭하면 즉시 정렬이 적용되고, 헤더 아이콘을 클릭하면 값 필터 패널이 열립니다. 코드로도 그룹핑 상태를 제어할 수 있습니다.

💡 TIP
groupBy() 옵션 객체에 allowSort: false , allowFilterByValue: false , allowFilterByList: false 를 추가하면 그룹 열의 정렬·필터를 개별적으로 제한할 수 있어 읽기 전용 집계 열을 만들 수 있습니다.

SpreadJS TableSheet로 재고 관리 시스템을 직접 만들어보기

카테고리별 재고 합계와 평균 단가를 자동 집계하는 재고 마스터 데모입니다. 실무에서는 autoSync: true 와 REST API를 연결하면 품목 추가·수정·삭제가 즉시 백엔드에 반영됩니다.

STEP 1: CDN

STEP 2: HTML

STEP 3: JavaScript

실행 결과
⭐ BEST PRACTICE
재주문점 이하 품목을 별도 집계하려면 summaryFields에 formula: '=COUNTIF([stock],"<10")' 수식을 추가하세요. 카테고리별 부족 품목 수를 즉시 파악할 수 있습니다. 실제 임계값은 [reorder] 필드를 기준으로 동적 조건을 설정하는 것이 좋습니다.

SpreadJS TableSheet 개발자 FAQ: 자주 묻는 질문

Q01

TableSheet와 일반 Worksheet는 어떻게 다른가요? 어떤 상황에서 TableSheet를 선택해야 할까요?

SpreadJS TableSheet는 DataManager와 결합해 자동 CRUD·집계 행·내장 필터를 제공하는 구조화 데이터 전용 시트 타입으로, 마스터 데이터 관리나 목록 화면처럼 테이블 형태의 데이터를 다룰 때 적합합니다. 반면 자유로운 셀 배치가 필요한 보고서 양식에는 일반 Worksheet를 사용하는 것이 맞습니다.

Q02

SpreadJS에서 REST API 데이터를 화면에 표시하고 행 추가·수정·삭제를 자동으로 처리하려면 어떻게 하나요?

DataManager의 addTable() 로 REST API를 DataConnector에 등록하고, remote 옵션에 read/create/update/delete URL을 각각 지정합니다. autoSync: true 를 추가하면 셀을 편집할 때마다 서버 API가 자동 호출되어 별도 저장 버튼 없이 실시간 CRUD가 완성됩니다.

Q03

JavaScript 그리드에서 그룹별 합계·평균·개수를 자동으로 집계하는 행을 추가하려면 어떻게 하나요?

sheet.groupBy() 메서드의 summaryFields 배열에 formula: '=SUM([fieldName])' 형식으로 집계 수식을 정의하면 그룹마다 집계 행이 자동으로 생성됩니다. SUM·AVERAGE·COUNT·MIN·MAX를 자유롭게 조합할 수 있고, 별도 수식 셀이나 추가 라이브러리가 필요 없습니다.

Q04

서버사이드 페이징·정렬·필터를 지원하는 JavaScript 데이터 그리드 라이브러리가 있나요?

SpreadJS DataManager는 OData 프로토콜을 기본 지원하므로, 서버사이드 처리를 활성화하면 $filter , $orderby , $skip , $top 파라미터가 REST 요청에 자동으로 추가됩니다. 클라이언트 내장 필터·정렬과 서버사이드 처리를 함께 사용할 수 있어 대용량 데이터 그리드 구현에 유리합니다.

Q05

SpreadJS TableSheet를 사용해 웹 기반 재고 관리 화면을 만들 수 있나요?

가능합니다. TableSheet와 DataManager 조합으로 품목 CRUD, 창고별 재고 현황, 카테고리별 SUM·AVERAGE 집계, 재주문점 이하 품목 필터링을 모두 구현할 수 있습니다. ERP·WMS 백엔드 REST API에 autoSync: true 로 연결하면 셀 편집 즉시 서버에 반영됩니다.

MESCIUS SpreadJS

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

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

SpreadJS 무료 체험판 다운로드