Wijmo FlexGrid XLSX 내보내기: 서버 없이 JavaScript로 엑셀 저장
데이터 그리드를 구축할 때 "Excel로 내보내기" 요청은 거의 빠지지 않습니다. 기존 방법은 서버 측 라이브러리(Apache POI, ClosedXML 등)에 의존해야 했지만, Wijmo의 wijmo.grid.xlsx
모듈을 사용하면 서버 없이 순수 클라이언트 JavaScript만으로 XLSX 파일을 생성합니다. FlexGridXlsxConverter.save()
메서드 한 줄로 그리드의 데이터·열 너비·셀 스타일을 그대로 담은 엑셀 파일을 즉시 다운로드할 수 있으며, formatItem
콜백으로 조건부 셀 색상 같은 고급 커스터마이징까지 지원합니다.
wijmo.grid.xlsx
모듈의 FlexGridXlsxConverter.save(grid, options, fileName)
호출 한 줄로 XLSX 내보내기를 구현합니다IFlexGridXlsxOptions
의 includeColumnHeaders
, includeStyles
, sheetName
옵션으로 출력 형식을 세밀하게 제어합니다formatItem
콜백의 XlsxFormatItemEventArgs.xlsxCell
로 셀 단위 배경색과 글꼴을 동적으로 지정합니다includeColumns
콜백으로 특정 열만 골라 내보내기에서 제외할 수 있습니다saveAsync()
로 비동기 처리하고 onProgress
콜백으로 진행률을 표시할 수 있습니다FlexGridXlsxConverter로 브라우저에서 XLSX를 만드는 원리
FlexGridXlsxConverter
는 @mescius/wijmo.grid.xlsx
패키지(CDN: wijmo.grid.xlsx.min.js
)에 포함된 정적 클래스입니다. 내부적으로 XLSX 파일 생성을 담당하는 wijmo.xlsx
모듈과 ZIP 처리 라이브러리 JSZip에 의존하므로, 세 가지 스크립트를 모두 로드해야 동작합니다.
주요 메서드는 두 가지입니다.
-
save(grid, options?, fileName?)— 동기 방식, JSZip 2.5 기반. 즉시 XLSX 파일을 생성·다운로드하며 반환값(Workbook)으로 추가 가공도 가능합니다. -
saveAsync(grid, options?, fileName?, onSaved?, onError?, onProgress?)— 비동기 방식, JSZip 3.x 기반. 수십만 행 대용량 데이터에 적합하고 진행률 콜백을 제공합니다.
이 글에서는 소·중규모 데이터에 적합한 동기 방식 save()
를 사용합니다.
예제 1: 버튼 하나로 그리드를 Excel 파일로 저장하기
판매 데이터를 담은 FlexGrid에 "Excel 내보내기" 버튼을 연결하는 기본 구현입니다.
STEP 1: 컨테이너와 XLSX용 추가 스크립트 준비
XLSX 내보내기는 Wijmo 기본 CDN 외에 jszip, wijmo.xlsx, wijmo.grid.xlsx 세 스크립트가 추가로 필요합니다. 그리드 컨테이너와 내보내기 버튼을 함께 준비합니다.
STEP 2: 판매 데이터로 FlexGrid 만들기
8개 제품의 판매 데이터를 CollectionView
로 바인딩하고 열별 형식을 지정합니다.
STEP 3: 완성 — 내보내기 버튼 연결하기
exportToExcel
함수를 추가한 최종 완성 코드입니다. HTML의 onclick
핸들러가 전역 스코프에서 접근할 수 있도록 반드시 window
에 노출합니다.
위 라이브 데모에서 "Excel 내보내기" 버튼을 클릭하면 판매현황.xlsx
파일이 즉시 다운로드됩니다. 열 너비·숫자 형식( n0
)·날짜 형식( yyyy-MM-dd
)이 그리드 외양 그대로 XLSX에 반영됩니다.
예제 2: 조건에 따라 Excel 셀 색상과 글꼴 바꾸기
formatItem
콜백을 활용하면 조건에 따라 Excel 셀의 배경색·글꼴을 동적으로 제어할 수 있습니다. 이 예제에서는 목표 달성률이 100% 이상이면 녹색, 80% 미만이면 빨간색, 나머지는 노란색으로 채색합니다.
STEP 1: 그리드를 담을 컨테이너 준비
STEP 2: 성과 데이터로 FlexGrid 만들기
달성률( achievement
) 열은 format: 'p1'
을 지정해 그리드에서 백분율로 표시합니다. 내부 데이터는 1.124
처럼 0~1 범위의 소수로 저장됩니다.
STEP 3: 완성 — 화면과 Excel 파일에 같은 조건부 스타일 적용
formatItem
콜백에서 args.xlsxCell.style.fill
과 args.xlsxCell.style.font
를 수정하면 Excel 셀에 조건부 서식이 반영됩니다. 하지만 이것만으로는 화면의 FlexGrid 자체는 그대로 남아있습니다 — Excel 내보내기와 완전히 별개의 파이프라인이기 때문입니다. 화면에도 같은 색을 보여주려면 FlexGrid 고유의 formatItem
이벤트( grid.formatItem.addHandler(...)
)에 동일한 조건 로직을 한 번 더 적용해야 합니다. 그리드는 셀 DOM 엘리먼트를 재사용하므로, 조건에 해당하지 않는 셀의 스타일을 매번 리셋하는 것이 중요합니다.
위 라이브 데모에서는 페이지가 로드되는 즉시 달성률 열이 초록·빨강·노란색으로 채색된 상태로 표시됩니다. 이 상태에서 버튼을 클릭하면 화면과 동일한 색상 규칙이 적용된 엑셀 파일이 다운로드됩니다. sheetName: '분기 성과 보고'
옵션으로 워크시트 이름도 별도 지정했습니다.
getCellData(row, col, false)
를 사용하는 이유는 format: 'p1'
이 적용된 열에서 형식화된 문자열( "112.4%"
)이 아니라 원시 숫자( 1.124
)를 가져와야 정확한 조건 비교가 가능하기 때문입니다. 그리드용 formatItem
이벤트와 Excel용 formatItem
콜백 모두에서 동일하게 적용됩니다.
formatItem
이벤트로 화면 셀에, FlexGridXlsxConverter
의 formatItem
콜백으로 Excel 셀에 각각 조건부 서식을 적용하면 화면과 내보내기 결과의 스타일을 일치시킬 수 있습니다.Excel 내보내기 옵션 한눈에 보기
IFlexGridXlsxOptions
인터페이스의 핵심 옵션을 정리합니다.
includeColumns
를 활용하면 특정 열을 내보내기에서 선택적으로 제외할 수 있습니다.
save()
메서드는 Workbook
객체를 반환하므로, 시트 이름 변경이나 다중 시트 구성 같은 추가 가공 후 book.save(fileName)
을 직접 호출하는 패턴도 가능합니다.
IFlexGridXlsxOptions
의 formatItem
과 includeColumns
옵션으로 Excel 출력 내용을 셀 단위까지 세밀하게 제어할 수 있습니다.AG Grid와 Excel 내보내기 방식 비교
Excel 내보내기 기능을 비교할 때 자주 언급되는 AG Grid와의 주요 차이점입니다.
AG Grid Community(무료): 기본적으로 CSV 내보내기만 제공합니다. 셀 스타일이 적용된 XLSX 내보내기( exportDataAsExcel
)는 Enterprise(유료) 에디션 전용 기능이어서 별도 라이선스 비용이 발생합니다.
Wijmo: 단일 라이선스로 FlexGridXlsxConverter
를 포함한 모든 내보내기 기능을 사용할 수 있습니다. 셀 스타일·열 너비·헤더 유지는 물론, React( @mescius/wijmo.react.grid
)·Vue·Angular 환경에서도 동일한 API로 동작합니다. 서버 없는 클라이언트 단 처리와 formatItem
을 통한 세밀한 셀 제어는 Enterprise급 기능 없이도 동급 수준을 제공합니다.
자주 묻는 질문 (FAQ)
Wijmo FlexGrid 데이터를 Excel(XLSX) 파일로 내보내려면 어떻게 하나요?
wijmo.xlsx
, wijmo.grid.xlsx
, jszip
세 모듈을 로드한 뒤 wijmo.grid.xlsx.FlexGridXlsxConverter.save(grid, { includeColumnHeaders: true }, 'output.xlsx')
를 호출합니다. 서버 없이 브라우저에서 바로 XLSX 파일이 생성·다운로드되며, 열 너비·숫자 형식·날짜 형식이 그리드에 보이는 그대로 반영됩니다.FlexGridXlsxConverter는 무엇이고 어떤 메서드를 제공하나요?
@mescius/wijmo.grid.xlsx
패키지에 포함된 정적 클래스로, FlexGrid 인스턴스를 XLSX Workbook 객체로 변환합니다. save()
(동기, JSZip 2.x)와 saveAsync()
(비동기, JSZip 3.x) 두 메서드를 제공하며, 셀 서식·열 너비·헤더가 포함된 XLSX를 생성합니다. 반환된 Workbook
객체로 시트 이름 변경, 다중 시트 구성 같은 추가 가공도 가능합니다.서버 없이 브라우저에서 Excel 파일을 만들 수 있는 JavaScript 그리드 라이브러리는 무엇인가요?
FlexGridXlsxConverter
가 대표적입니다. JSZip과 Wijmo xlsx 모듈이 브라우저 메모리 안에서 XLSX 파일 구조를 직접 만들기 때문에 백엔드 API 호출 없이 클라이언트에서 완전한 Excel 파일을 내보낼 수 있습니다. 네트워크 상태와 무관하게 동작한다는 점도 장점입니다.셀 서식과 병합을 유지한 채 XLSX로 내보낼 수 있는 그리드 컴포넌트는 무엇인가요?
FlexGridXlsxConverter
는 그리드 데이터를 XLSX 파일로 내보내는 기능을 제공합니다. includeStyles: true
옵션은 기본값으로, FlexGrid 셀에 적용된 지원 가능한 스타일을 XLSX 셀 서식에 반영합니다.
또한 병합된 셀과 그리드의 열 너비가 XLSX 파일에 반영되며, formatItem
콜백을 사용하면 셀별 배경색, 글꼴, 값 등 내보내기 결과를 추가로 조정할 수 있습니다.대용량 데이터를 서버 없이 Excel로 내보내려면 어떻게 하나요?
FlexGridXlsxConverter.saveAsync()
는 JSZip 3.x 기반 비동기 방식으로 대용량 데이터를 처리합니다. onProgress
콜백으로 진행률 표시를 구현할 수 있고, batchSize
파라미터로 행 단위 배치 크기를 조절해 메모리 부담을 줄일 수 있어 수만 행 이상의 데이터에도 적합합니다.
