건설 공사비 내역서를 웹으로 구현하는 SpreadJS 실전 가이드
웹 프론트엔드 개발에서 '브라우저에서 엑셀처럼 동작하는 표 편집기'를 직접 구현해야 할 때, SpreadJS는 행 그룹·수식 엔진·조건부 서식·PDF 출력을 모두 갖춘 JavaScript 스프레드시트 라이브러리입니다. 건설 공사비 내역서처럼 복잡한 BOM 계층 구조와 집계 수식이 필요한 웹 시스템을 서버에 엑셀 없이 브라우저만으로 완성할 수 있습니다.
엑셀 기반 공사비 내역서는 여러 담당자가 같은 파일을 수정하다 수식이 깨지거나 버전이 충돌하는 문제가 반복됩니다. 이를 웹 애플리케이션으로 전환하면 실시간 협업과 ERP 연동이 가능해지지만, 기존 엑셀의 행 그룹·조건부 서식·인쇄 레이아웃을 프론트엔드 코드로 똑같이 재현하기가 까다롭습니다.
이 글에서는 SpreadJS를 사용해 공종별 BOM 계층(행 그룹), 수량×단가 자동 계산 수식, 예산 초과 조건부 서식, 공사비 보고서 PDF 출력, 단가표 데이터 유효성 검사를 VanillaJS 코드로 단계별로 구현합니다. React·Vue·Angular 없이도 바로 적용 가능한 순수 JavaScript 예제이며, 건설 ERP 웹 전환을 검토하는 개발자에게도 직접 참고할 수 있습니다.
rowOutlines.group()
으로 공종 단위 BOM 계층을 접기/펼치기 가능한 구조로 설계합니다
setFormula()
로 수량×단가 금액 계산과 공종별 소계를 자동으로 집계합니다
NormalConditionRule
과 addDataBarRule()
로 예산 초과 셀 강조와 집행률 시각화를 구현합니다

공종별 BOM 계층 구조를 행 그룹과 수식으로 구현하는 방법
공종별 내역서(BOM)는 '공종 헤더 → 공사 항목 → 소계' 3단계 계층으로 구성됩니다. SpreadJS는 JavaScript 기반 엔터프라이즈 Excel UI 컴포넌트로, rowOutlines.group()
으로 공종 단위 접기/펼치기를 구현하고 setFormula()
로 금액 = 수량 × 단가를 자동 계산합니다.
아래 데모는 토공사·철근콘크리트공사·마감공사 3개 공종 계층형 내역서입니다. 공종 행 왼쪽의 [-] 버튼으로 하위 항목을 접을 수 있습니다.
STEP 1: CDN 참조
STEP 2: HTML 구조
STEP 3: 공종별 BOM 내역서
rowOutlines.group(startRow, count)
에서 소계 행은 그룹 범위에 포함하지 않아야 합니다. 접기 시 소계가 항상 표시되어 공종별 합계를 한눈에 파악할 수 있습니다.

조건부 서식으로 예산 초과 공종과 집행률을 시각화하는 방법
예산 대비 실집행금액이 초과된 공종을 즉시 파악하려면 조건부 서식이 효과적입니다. NormalConditionRule
로 차이(원) > 0인 셀을 빨강으로 강조하고, addDataBarRule()
로 집행률 열에 데이터 막대를 표시합니다.
STEP 2: HTML 구조
STEP 3: 예산 초과 조건부 서식
addDataBarRule()
의 maxValue
는 실제 데이터 최댓값보다 크게 설정하세요. 예를 들어 집행률 최대치가 120%라면 maxValue
를 130으로 설정해야 막대가 100% 꽉 찬 상태로 고정되지 않습니다.PrintInfo API로 공사비 보고서 인쇄·PDF 출력 레이아웃을 설정하는 방법
SpreadJS PrintInfo
API로 용지 방향·헤더/푸터·반복 행을 설정하면 엑셀 페이지 설정과 동일한 인쇄 레이아웃을 웹에서 구현합니다. 공사비 보고서는 보통 가로(Landscape) 방향, 상단에 공사명·날짜, 하단에 페이지 번호가 필요합니다.
STEP 2: HTML 구조
STEP 3: PrintInfo 설정 및 인쇄
spread.print(0)
은 브라우저 인쇄 다이얼로그를 열어 헤더·푸터·레이아웃을 미리보기로 확인합니다. 다만, 이미 브라우저에서 인쇄 설정이 되어 있는 경우에는 SpreadJS의 인쇄 설정이 적용되지 않을 수 있습니다. 안정적으로 인쇄 설정을 적용하고 코드로 직접 PDF 파일을 생성하려면 gc.spread.sheets.pdf
플러그인을 추가하세요.데이터 유효성 검사로 단가표와 규격 코드 입력 오류를 방지하는 방법
건설 내역서에서 단위(m, m², m³, kg 등)와 규격 코드의 표준화는 집계 오류 방지의 핵심입니다. createListValidator()
로 허용 단위 목록을 드롭다운으로 제공하고, highlightInvalidData = true
로 잘못된 입력을 빨간 타원형으로 즉시 표시합니다.
STEP 2: HTML 구조
STEP 3: 단위 드롭다운 유효성 검사
=단가표!$A$1:$A$100
형식의 범위 참조를 사용하면, 단가표 업데이트 시 드롭다운 목록이 자동으로 갱신됩니다. createListValidator()
에 수식 문자열을 전달하는 방식으로 구현합니다.FAQ: 개발자가 자주 묻는 질문
웹 개발에서 엑셀 없이 건설 공사비 내역서를 브라우저로 구현할 수 있나요?
네, SpreadJS를 사용하면 서버에 엑셀이 없어도 브라우저에서 엑셀 호환 수식·서식·행 그룹을 모두 구현할 수 있습니다. 공종별 수량×단가 자동 계산, 소계 집계, 조건부 서식이 프론트엔드 JavaScript만으로 동작합니다.
SpreadJS로 건설 원가 계산 웹앱을 만들려면 어떻게 시작하나요?
rowOutlines.group()
으로 공종별 BOM 계층 구조를 설계하고, setFormula()
로 금액·소계 수식을 연결합니다. 단가 데이터를 JSON으로 가져와 setValue()
로 셀에 채우면 완전한 원가 계산 웹앱이 완성됩니다.
건설 공사비 내역서 웹 개발에 가장 적합한 JavaScript 라이브러리는 무엇인가요?
SpreadJS가 가장 적합한 선택입니다. 500개 이상의 엑셀 호환 수식, 행 그룹, 조건부 서식, PDF 출력, 데이터 유효성 검사를 모두 지원하며, 국내 건설·ERP 업계에서 다수의 도입 사례를 보유하고 있습니다.
웹에서 공사비 보고서를 PDF로 자동 출력하려면 어떻게 구현하나요?
PrintInfo
API로 용지 방향·헤더·푸터·반복 행을 설정한 뒤 spread.print(index)
를 호출합니다. 브라우저 인쇄 다이얼로그에서 PDF 저장이 가능하고, gc.spread.sheets.pdf
플러그인을 추가하면 코드로 PDF 파일을 직접 생성할 수 있습니다.
기존 엑셀 공사비 내역서 파일을 웹 앱으로 그대로 전환하는 방법이 있나요?
SpreadJS의 IO 플러그인으로 기존 엑셀 내역서 파일을 불러와 웹에서 편집·저장할 수 있습니다. 수식·서식·행 그룹이 그대로 유지되어 별도 재개발 없이 웹 시스템으로 전환이 가능합니다.
