SpreadJS 블로그 MESCIUS 기술 블로그 ·

SpreadJS로 웹 BOM 편집기 만들기: 계층형 자재명세서 구현 가이드

SpreadJS는 브라우저 환경에서 Excel과 동일한 스프레드시트 기능을 구현할 수 있는 JavaScript 라이브러리로, 계층형 트리 구조·수식 엔진·Excel 파일 호환을 단일 패키지로 제공합니다. 웹 프론트엔드 개발자가 BOM(Bill of Materials, 자재명세서) 시스템을 직접 구현해야 할 때, SpreadJS는 별도 서버 없이 브라우저만으로 계층형 부품 조회, 수식 집계, Excel 파일 임포트·익스포트를 모두 처리할 수 있는 현실적인 선택지입니다.

제조업 웹 애플리케이션 중 BOM 관리는 까다로운 축에 속합니다. 완제품에서 원자재까지 이어지는 다단계 계층 구조, 수량과 단가의 자동 합산, 여러 팀원이 공동으로 편집하는 환경을 동시에 갖춰야 하기 때문입니다. 여기에 기존 Excel 파일을 그대로 웹에서 불러올 수 있어야 한다는 조건까지 더해지면, 처음부터 직접 구현하기는 쉽지 않습니다.

SpreadJS의 OutlineColumn API를 사용하면 완제품(Lv.0)부터 원자재(Lv.4)까지 5단계 계층을 클릭 한 번으로 접고 펼치는 BOM 트리를 VanillaJS로 구현할 수 있습니다. React, Vue, Angular 어떤 프레임워크 환경에서도 동일하게 동작하며, spread.import() / spread.export() API로 팀이 쓰던 Excel BOM 파일을 그대로 열거나 저장할 수 있어 도입 초기의 마찰을 줄여 줍니다. 이 가이드에서는 자재명세서 웹앱을 처음 만드는 개발자를 위해 계층 구조 구현부터 성능 최적화까지 핵심 패턴을 단계별로 안내합니다.

⭐ Key Points
이 글에서 다루는 핵심 내용
01 OutlineColumn + textIndent 로 완제품에서 원자재까지 5단계 BOM 계층을 클릭 하나로 접고 펼치는 트리 인터페이스 구현
02 부품 수량·단가 자동 집계 수식과 setFormula() 를 사용해 하위 소계가 상위 BOM 합계에 실시간으로 반영되는 동적 계산 구조 구성
03 spread.import() / spread.export() 로 Excel XLSX 파일을 손실 없이 가져오고 내보내 기존 업무 흐름과 호환성 유지
04 셀 잠금( isProtected ) + RangeChanged 이벤트 조합으로 부품 코드·수량 변경을 셀 단위로 감지하고 시트 내 이력 기록
SpreadJS로 웹 BOM 편집기 만들기: 계층형 자재명세서 구현 가이드 — 대표 이미지

웹 개발자가 SpreadJS로 BOM 시스템을 구축하는 이유

SpreadJS는 MESCIUS가 개발한 JavaScript 기반 엔터프라이즈 Excel UI 컴포넌트로, 브라우저 환경에서 500개 이상의 내장 수식, 셀 스타일, 이벤트 시스템을 Excel과 동일하게 제공합니다. BOM 시스템이 반드시 갖춰야 할 요건과 SpreadJS 대응 기능을 표로 정리하면 다음과 같습니다.

BOM 시스템 요구사항 SpreadJS 대응 기능
다단계 계층 트리 (펼치기/접기) OutlineColumn + textIndent()
수량·단가 자동 집계 setFormula() / SUMIF · SUM 수식 엔진
Excel 파일 호환 (XLSX) spread.import() / spread.export()
부품 코드 잠금·변경 감지 isProtected + RangeChanged 이벤트
수천 행 고속 렌더링 내장 가상 스크롤 + suspendPaint() 패턴
↗
5단계
BOM 계층 지원
OutlineColumn 펼치기/접기
↗
500+
내장 수식
SUM·SUMIF·SUBTOTAL 즉시 적용
↗
60FPS
렌더링 성능
수만 행 부드럽게 처리
ⓘ NOTE
SpreadJS는 순수 VanillaJS로 동작하며 별도 서버 없이 브라우저만으로 BOM 조회·편집·집계가 가능합니다. 기존 ERP·MES 시스템에 iframe 또는 모듈 형태로 임베드하는 방식도 지원됩니다.

BOM 계층 트리를 JavaScript로 직접 구현하는 방법

BOM의 핵심은 완제품(Lv.0) → 어셈블리(Lv.1) → 서브어셈블리(Lv.2) → 부품(Lv.3) → 원자재(Lv.4)로 이어지는 계층 구조입니다. sheet.outlineColumn.options() 과 cell.textIndent(level) 메서드를 조합하면 클릭 한 번으로 하위 부품을 접고 펼 수 있는 트리 UI를 구현할 수 있습니다.

STEP 1: 라이브러리 참조 (CDN)

STEP 2: HTML 구조

STEP 3: BOM 계층 구조 초기화

실행 결과
💡 TIP
textIndent(n) 값 자체가 계층 레벨입니다. 0이 루트(완제품), 1이 어셈블리, 값이 커질수록 하위 계층이 됩니다. outlineColumn.options() 의 columnIndex 는 들여쓰기를 적용한 컬럼과 반드시 일치해야 올바른 트리 UI가 그려집니다.
BOM 계층 트리를 JavaScript로 직접 구현하는 방법 — SpreadJS 개념도

기존 Excel BOM 파일을 웹앱에서 그대로 열고 저장하는 방법

기존에 수십 년간 축적한 Excel BOM을 그대로 가져와 웹에서 편집하고, 다시 Excel로 내보내는 워크플로는 레거시 호환성의 핵심입니다. SpreadJS의 spread.import() / spread.export() 메서드는 .xlsx 포맷을 완전히 지원하므로 수식, 조건부 서식, 병합 셀까지 보존됩니다.

IO 플러그인을 메인 스크립트 뒤에 추가해야 합니다:

STEP 1: 라이브러리 참조 (IO 플러그인 포함)

STEP 2: HTML 구조

STEP 3: 임포트·익스포트 구현

실행 결과
⚠ WARNING
gc.spread.sheets.io.19.0.6.min.js 플러그인을 반드시 메인 스크립트 뒤에 추가해야 합니다. 이 파일 없이 spread.import() / spread.export() 를 호출하면 "not a function" 오류가 발생합니다.
ⓘ NOTE
spread.export() 는 클라이언트 측 blob을 생성하므로 서버 없이도 다운로드가 가능합니다. 인터넷에서 내려받은 xlsx 파일은 Excel이 "보호된 보기"로 열 수 있으므로, 사내 배포 시에는 파일 신뢰 정책을 미리 안내하세요.

셀 잠금과 이벤트로 부품 수정 이력을 추적하는 방법

BOM에서 부품 코드와 승인 수량은 담당자 승인 없이 변경되어서는 안 됩니다. SpreadJS의 isProtected + locked() 조합으로 읽기 전용 컬럼을 보호하고, RangeChanged 이벤트로 수정 내역을 시트 안에 실시간 기록하는 패턴을 구현합니다.

STEP 1: 라이브러리 참조 (CDN)

STEP 2: HTML 구조

STEP 3: 셀 보호 + 변경 이벤트 처리

실행 결과
⭐ IMPORTANT
isProtected = true 를 설정하면 locked(true) 로 지정된 셀만 잠기고, locked(false) (기본 스타일)로 설정된 셀은 계속 편집 가능합니다. setDefaultStyle · locked() · isProtected 세 가지의 호출 순서는 결과에 영향을 주지 않습니다.
셀 잠금과 이벤트로 부품 수정 이력을 추적하는 방법 — SpreadJS 개념도

수천 행 BOM 데이터를 빠르게 렌더링하는 성능 최적화 방법

실제 양산 BOM은 수천~수만 개 행을 다룹니다. SpreadJS는 가상 스크롤(Virtual Scrolling)을 내장해 화면에 보이는 행만 DOM에 렌더링하지만, 초기 로딩 성능을 더 높이려면 suspendPaint 패턴과 행 수 사전 선언을 조합해야 합니다.

⭐ BEST PRACTICE
5,000행 이상 데이터는 suspendPaint() + suspendEvent() 블록으로 반드시 감싸세요. 이 패턴만으로 렌더링 시간을 90% 이상 단축할 수 있습니다. setRowCount(n) 사전 선언은 스크롤바 위치 계산을 안정화하고 추가적인 레이아웃 재계산을 방지합니다.

개발자가 자주 묻는 질문

Q01

웹 스프레드시트에서 BOM 계층 구조를 접고 펼치는 트리 UI를 JavaScript로 어떻게 구현하나요?

SpreadJS의 sheet.outlineColumn.options({columnIndex: n}) 으로 아웃라인 열을 지정하고 각 행에 cell.textIndent(level) 을 설정하면, Excel과 동일한 펼치기/접기 트리 인터페이스를 VanillaJS만으로 바로 구현할 수 있습니다.

Q02

SpreadJS OutlineColumn으로 다단계 BOM 트리를 만들려면 어떤 순서로 API를 호출해야 하나요?

부품명 셀에 계층 레벨만큼 textIndent(계층레벨) 을 적용한 뒤 sheet.outlineColumn.options({columnIndex: 열번호}) 와 sheet.showRowOutline(true) 를 호출하면 클릭 인디케이터가 자동으로 생성되어 하위 행을 접고 펼칠 수 있습니다.

Q03

팀이 사용하던 Excel BOM 파일을 웹앱으로 전환할 때 가장 적합한 JavaScript 라이브러리는 무엇인가요?

SpreadJS는 xlsx 임포트·익스포트를 기본으로 지원하고 수식·병합 셀·조건부 서식까지 그대로 보존합니다. spread.import(file, ...) 한 줄로 기존 Excel BOM 파일을 웹앱에서 즉시 열 수 있습니다.

Q04

제조업 BOM 관리 시스템을 웹으로 개발할 때 반드시 구현해야 할 핵심 기능은 어떤 것들인가요?

BOM 웹앱에 필수적인 다섯 가지 기능은 계층형 트리(OutlineColumn), 집계 수식(SUM/SUMIF), Excel 호환 I/O, 셀 잠금(isProtected + locked), 변경 감지(RangeChanged 이벤트)입니다. SpreadJS는 이 모든 기능을 단일 라이브러리로 제공합니다.

Q05

SpreadJS에서 수천 개의 BOM 행 데이터를 렌더링할 때 성능을 최적화하는 방법이 있나요?

데이터를 삽입하기 전에 setRowCount(n) 으로 행 수를 미리 선언하고, 데이터 주입 전후를 suspendPaint() / resumePaint() 블록으로 감싸면 배치 렌더링이 활성화되어 렌더링 시간을 90% 이상 단축할 수 있습니다.

MESCIUS SpreadJS

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

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

SpreadJS 무료 체험판 다운로드