SpreadJS 블로그 MESCIUS 기술 블로그 ·

웹 앱에서 다중 창고 재고 현황판 구현하기 — SpreadJS 활용법

웹 프론트엔드 개발자가 창고 재고 현황을 관리하는 화면을 만들어야 한다면, HTML 테이블만으로는 금세 한계를 만납니다. 수만 행의 SKU 목록을 한 화면에 나열하면 브라우저가 느려지고, 셀 색상 규칙을 직접 관리하려면 로직이 복잡해집니다. SpreadJS는 MESCIUS가 개발한 JavaScript 스프레드시트 컴포넌트로, 가상화 렌더링·조건부 서식·스파크라인을 하나의 라이브러리에서 제공해 이 문제를 직접 해결합니다.

React·Vue·Angular 또는 Vanilla JS 프로젝트에서 "엑셀처럼 동작하는 그리드"가 필요한 순간이 있습니다. 창고마다 탭 색상을 지정하고, 재고 임계값에 따라 셀 색상을 자동으로 바꾸며, 품목별 추이를 셀 내 미니 차트로 보여주는 기능을 직접 구현하려면 상당한 시간이 걸립니다. SpreadJS는 이런 요구사항을 API 몇 줄로 처리해 WMS·물류 대시보드 개발 기간을 단축합니다.

이 글에서는 SpreadJS CDN 로드부터 시작해 다중 창고 시트 구성, 조건부 서식, 가상화 렌더링, 폴링 갱신, 스파크라인까지 단계별로 구현하는 방법을 소개합니다. 각 단계에 실행 가능한 데모 코드가 포함되어 있어 바로 테스트해볼 수 있습니다.

⭐ Key Points
이 글에서 다루는 핵심 내용
01 가상화 렌더링: SpreadJS는 화면에 보이는 행만 실제로 그려 수만 행 SKU 데이터도 스크롤 지연 없이 처리합니다
02 시트 탭 색상( sheetTabColor ): 창고마다 탭 색상을 지정해 여러 창고 현황을 직관적으로 구분할 수 있습니다
03 조건부 서식( ConditionalFormats ): 임계값 기반 규칙을 등록하면 재고 부족·주의·정상 상태를 자동으로 색상 알림합니다
04 스파크라인: 품목별 7일 입출고 데이터를 셀 내 인라인 차트로 시각화해 추이를 한눈에 파악합니다
웹 앱에서 다중 창고 재고 현황판 구현하기 — SpreadJS 활용법 — 대표 이미지

창고별 시트를 색상 탭으로 구분하는 방법: 다중 창고 UI 설계하기

물류 대시보드의 첫 설계 과제는 창고 단위 시트 분리입니다. SpreadJS는 워크시트를 동적으로 추가하고, sheet.options.sheetTabColor 속성으로 탭에 창고별 색상을 지정할 수 있습니다. Excel에서 익숙한 시트 탭 색상 구분 방식을 그대로 웹에 구현합니다.

아래 데모는 인천·부산·대구 3개 창고 시트를 색상 탭으로 분리하고, 각 창고의 SKU 재고 현황을 즉시 조회할 수 있는 기본 구조를 보여줍니다.

STEP 1: CDN 참조

STEP 2: HTML 구조

STEP 3: JavaScript

실행 결과
창고별 시트를 색상 탭으로 구분하는 방법: 다중 창고 UI 설계하기 — SpreadJS 개념도

재고 부족·주의·정상을 자동 색상으로 표시하는 방법: 조건부 서식 구현 가이드

SpreadJS 조건부 서식은 sheet.conditionalFormats.addCellValueRule() 로 구현합니다. 비교 연산자( ComparisonOperators )와 임계값, 적용 스타일, 대상 범위를 지정하면 셀 값이 바뀔 때마다 자동으로 색상이 업데이트됩니다. 재고 수량 열에 세 가지 규칙(부족/주의/정상)을 적용하면 폴링 갱신 시에도 색상이 자동 반영됩니다.

실행 결과
⭐ IMPORTANT
조건부 서식 규칙은 나중에 추가한 규칙이 높은 우선순위로 평가됩니다. 가장 엄격한 조건(재고 부족)을 마지막에 추가해 최우선으로 적용되도록 설계하세요.

수만 개 SKU를 버벅임 없이 렌더링하는 방법: SpreadJS 가상화란?

SpreadJS는 가상화 렌더링으로 100만 셀 이상을 지연 없이 처리해 물류 WMS 대시보드 구현에 최적입니다. 화면에 보이는 행만 실제 DOM에 렌더링하기 때문에 5만 행 SKU 목록도 초기 로드 시간에 영향을 주지 않습니다.

성능 최적화의 핵심은 데이터 입력 전 suspendPaint() 로 렌더링을 일시 정지하고, 완료 후 resumePaint() 를 호출하는 패턴입니다.

ⓘ NOTE
setArray() 는 루프 방식보다 빠르게 대용량 데이터를 입력합니다. API 응답 JSON을 2차원 배열로 매핑한 뒤 sheet.setArray(startRow, startCol, dataArray) 로 한 번에 적용하세요.
⭐ BEST PRACTICE
초기 로드 시 sheet.setRowCount() 로 예상 행 수를 미리 지정하면 내부 버퍼 재할당이 줄어 렌더링이 더욱 빨라집니다.

재고 현황판을 자동으로 실시간 갱신하는 방법: 폴링 패턴 구현하기

창고 재고는 실시간으로 변합니다. SpreadJS의 RangeChanged 이벤트와 setArray() 를 조합하면 주기적 API 폴링으로 현황판을 자동 갱신할 수 있습니다.

⚠ WARNING
보호된 시트( isProtected=true )에서는 RangeChanged 이벤트가 작동하지 않습니다. 보호 시트에서 값 변경을 감지하려면 CellChanged 이벤트와 propertyName === 'value' 조건을 함께 사용하세요.
재고 현황판을 자동으로 실시간 갱신하는 방법: 폴링 패턴 구현하기 — SpreadJS 개념도

셀 안에 7일 입출고 추이 차트를 넣는 방법: 스파크라인 구현하기

별도 차트 영역 없이 셀 내부에 7일 추이를 시각화하면 재고 담당자가 스크롤 없이 트렌드를 확인할 수 있습니다. SpreadJS 스파크라인은 sheet.setSparkline() 으로 구현하며, 같은 행의 여러 열에 걸친 데이터는 DataOrientation.horizontal 을 사용합니다.

STEP 1: CDN 참조

STEP 2: HTML 구조

STEP 3: 스파크라인 구현

실행 결과
💡 TIP
스파크라인 데이터 열을 setColumnWidth(c, 0) 으로 숨기면 스파크라인이 데이터를 읽지 못합니다. 보조 데이터를 숨겨야 한다면 별도 시트에 저장하고 크로스시트 범위 문자열( 'DataSheet!A1:G1' )로 참조하세요.
↗
100만+
셀 가상화 렌더링
스크롤 지연 없이 처리
↗
500+
내장 Excel 수식
xlsx 서식 완전 호환
↗
3,000+
글로벌 도입 기업
엔터프라이즈 검증 완료

개발자가 자주 묻는 질문

Q01

JavaScript로 수만 행 재고 데이터를 웹에서 지연 없이 보여주려면 어떤 라이브러리를 써야 하나요?

SpreadJS는 가상화 렌더링 방식으로 100만 셀 이상을 지연 없이 처리합니다. 화면에 보이는 행만 실제로 렌더링하며, suspendPaint() + setArray() 패턴으로 대용량 데이터를 한 번에 반영할 수 있어 물류 WMS 대시보드 구현에 적합합니다.

Q02

순수 JavaScript로 Excel처럼 작동하는 재고 현황판을 웹에서 만들 수 있나요?

SpreadJS를 CDN으로 불러온 뒤 new GC.Spread.Sheets.Workbook(container) 으로 워크북을 초기화하고, sheet.setValue() , sheet.setArray() , conditionalFormats.addCellValueRule() 을 조합하면 Excel과 동일한 조건부 서식·시트 탭 구조를 프레임워크 없이 순수 JavaScript로 구현할 수 있습니다.

Q03

웹 앱에서 재고 수량에 따라 셀 색상을 자동으로 변경하는 조건부 서식을 어떻게 구현하나요?

SpreadJS의 조건부 서식 API를 사용하면 임계값에 따라 셀 색상이 자동으로 바뀝니다. sheet.conditionalFormats.addCellValueRule(ComparisonOperators.lessThan, 임계값, undefined, 빨간스타일, 범위) 형태로 재고 부족 규칙을 추가하고, 같은 방식으로 주의·정상 규칙을 겹쳐 적용하면 됩니다.

Q04

서버에서 가져온 재고 데이터를 웹 스프레드시트에 실시간으로 반영하려면 어떻게 해야 하나요?

SpreadJS는 setArray() 로 폴링 데이터를 일괄 업데이트하고, RangeChanged 이벤트로 셀 변경을 감지해 서버와 즉시 동기화할 수 있습니다. REST API 폴링이나 WebSocket과 조합해 여러 창고의 재고 현황을 실시간으로 갱신하는 대시보드를 구현합니다.

Q05

SheetJS, Handsontable과 SpreadJS를 비교했을 때 물류 대시보드 구현에 어떤 차이가 있나요?

SheetJS는 파일 파싱 전용 라이브러리이므로 대화형 대시보드 UI는 별도로 개발해야 합니다. Handsontable은 기본 그리드를 제공하지만 Excel 수준의 조건부 서식·시트 탭·스파크라인이 없어 추가 구현이 필요합니다. SpreadJS는 이 기능을 하나의 컴포넌트에 내장하며, 500개 이상의 Excel 호환 수식도 포함되어 물류 WMS 대시보드에 더 적합합니다.

MESCIUS SpreadJS

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

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

SpreadJS 무료 체험판 다운로드