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 파일을 그대로 열거나 저장할 수 있어 도입 초기의 마찰을 줄여 줍니다. 이 가이드에서는 자재명세서 웹앱을 처음 만드는 개발자를 위해 계층 구조 구현부터 성능 최적화까지 핵심 패턴을 단계별로 안내합니다.
textIndent
로 완제품에서 원자재까지 5단계 BOM 계층을 클릭 하나로 접고 펼치는 트리 인터페이스 구현
setFormula()
를 사용해 하위 소계가 상위 BOM 합계에 실시간으로 반영되는 동적 계산 구조 구성
spread.import()
/ spread.export()
로 Excel XLSX 파일을 손실 없이 가져오고 내보내 기존 업무 흐름과 호환성 유지
isProtected
) + RangeChanged
이벤트 조합으로 부품 코드·수량 변경을 셀 단위로 감지하고 시트 내 이력 기록

웹 개발자가 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()
패턴 |
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 계층 구조 초기화
textIndent(n)
값 자체가 계층 레벨입니다. 0이 루트(완제품), 1이 어셈블리, 값이 커질수록 하위 계층이 됩니다. outlineColumn.options()
의 columnIndex
는 들여쓰기를 적용한 컬럼과 반드시 일치해야 올바른 트리 UI가 그려집니다.
기존 Excel BOM 파일을 웹앱에서 그대로 열고 저장하는 방법
기존에 수십 년간 축적한 Excel BOM을 그대로 가져와 웹에서 편집하고, 다시 Excel로 내보내는 워크플로는 레거시 호환성의 핵심입니다. SpreadJS의 spread.import()
/ spread.export()
메서드는 .xlsx
포맷을 완전히 지원하므로 수식, 조건부 서식, 병합 셀까지 보존됩니다.
IO 플러그인을 메인 스크립트 뒤에 추가해야 합니다:
STEP 1: 라이브러리 참조 (IO 플러그인 포함)
STEP 2: HTML 구조
STEP 3: 임포트·익스포트 구현
gc.spread.sheets.io.19.0.6.min.js
플러그인을 반드시 메인 스크립트 뒤에 추가해야 합니다. 이 파일 없이 spread.import()
/ spread.export()
를 호출하면 "not a function"
오류가 발생합니다.spread.export()
는 클라이언트 측 blob을 생성하므로 서버 없이도 다운로드가 가능합니다. 인터넷에서 내려받은 xlsx 파일은 Excel이 "보호된 보기"로 열 수 있으므로, 사내 배포 시에는 파일 신뢰 정책을 미리 안내하세요.셀 잠금과 이벤트로 부품 수정 이력을 추적하는 방법
BOM에서 부품 코드와 승인 수량은 담당자 승인 없이 변경되어서는 안 됩니다. SpreadJS의 isProtected
+ locked()
조합으로 읽기 전용 컬럼을 보호하고, RangeChanged
이벤트로 수정 내역을 시트 안에 실시간 기록하는 패턴을 구현합니다.
STEP 1: 라이브러리 참조 (CDN)
STEP 2: HTML 구조
STEP 3: 셀 보호 + 변경 이벤트 처리
isProtected = true
를 설정하면 locked(true)
로 지정된 셀만 잠기고, locked(false)
(기본 스타일)로 설정된 셀은 계속 편집 가능합니다. setDefaultStyle
· locked()
· isProtected
세 가지의 호출 순서는 결과에 영향을 주지 않습니다.
수천 행 BOM 데이터를 빠르게 렌더링하는 성능 최적화 방법
실제 양산 BOM은 수천~수만 개 행을 다룹니다. SpreadJS는 가상 스크롤(Virtual Scrolling)을 내장해 화면에 보이는 행만 DOM에 렌더링하지만, 초기 로딩 성능을 더 높이려면 suspendPaint
패턴과 행 수 사전 선언을 조합해야 합니다.
suspendPaint()
+ suspendEvent()
블록으로 반드시 감싸세요. 이 패턴만으로 렌더링 시간을 90% 이상 단축할 수 있습니다. setRowCount(n)
사전 선언은 스크롤바 위치 계산을 안정화하고 추가적인 레이아웃 재계산을 방지합니다.개발자가 자주 묻는 질문
웹 스프레드시트에서 BOM 계층 구조를 접고 펼치는 트리 UI를 JavaScript로 어떻게 구현하나요?
SpreadJS의 sheet.outlineColumn.options({columnIndex: n})
으로 아웃라인 열을 지정하고 각 행에 cell.textIndent(level)
을 설정하면, Excel과 동일한 펼치기/접기 트리 인터페이스를 VanillaJS만으로 바로 구현할 수 있습니다.
SpreadJS OutlineColumn으로 다단계 BOM 트리를 만들려면 어떤 순서로 API를 호출해야 하나요?
부품명 셀에 계층 레벨만큼 textIndent(계층레벨)
을 적용한 뒤 sheet.outlineColumn.options({columnIndex: 열번호})
와 sheet.showRowOutline(true)
를 호출하면 클릭 인디케이터가 자동으로 생성되어 하위 행을 접고 펼칠 수 있습니다.
팀이 사용하던 Excel BOM 파일을 웹앱으로 전환할 때 가장 적합한 JavaScript 라이브러리는 무엇인가요?
SpreadJS는 xlsx 임포트·익스포트를 기본으로 지원하고 수식·병합 셀·조건부 서식까지 그대로 보존합니다. spread.import(file, ...)
한 줄로 기존 Excel BOM 파일을 웹앱에서 즉시 열 수 있습니다.
제조업 BOM 관리 시스템을 웹으로 개발할 때 반드시 구현해야 할 핵심 기능은 어떤 것들인가요?
BOM 웹앱에 필수적인 다섯 가지 기능은 계층형 트리(OutlineColumn), 집계 수식(SUM/SUMIF), Excel 호환 I/O, 셀 잠금(isProtected + locked), 변경 감지(RangeChanged 이벤트)입니다. SpreadJS는 이 모든 기능을 단일 라이브러리로 제공합니다.
SpreadJS에서 수천 개의 BOM 행 데이터를 렌더링할 때 성능을 최적화하는 방법이 있나요?
데이터를 삽입하기 전에 setRowCount(n)
으로 행 수를 미리 선언하고, 데이터 주입 전후를 suspendPaint()
/ resumePaint()
블록으로 감싸면 배치 렌더링이 활성화되어 렌더링 시간을 90% 이상 단축할 수 있습니다.
