Wijmo 블로그 MESCIUS 기술 블로그 ·

Wijmo FlexGrid XLSX 내보내기: 서버 없이 JavaScript로 엑셀 저장

데이터 그리드를 구축할 때 "Excel로 내보내기" 요청은 거의 빠지지 않습니다. 기존 방법은 서버 측 라이브러리(Apache POI, ClosedXML 등)에 의존해야 했지만, Wijmo의 wijmo.grid.xlsx 모듈을 사용하면 서버 없이 순수 클라이언트 JavaScript만으로 XLSX 파일을 생성합니다. FlexGridXlsxConverter.save() 메서드 한 줄로 그리드의 데이터·열 너비·셀 스타일을 그대로 담은 엑셀 파일을 즉시 다운로드할 수 있으며, formatItem 콜백으로 조건부 셀 색상 같은 고급 커스터마이징까지 지원합니다.

⭐
Key Points
이 글에서 다루는 핵심 내용
01
wijmo.grid.xlsx 모듈의 FlexGridXlsxConverter.save(grid, options, fileName) 호출 한 줄로 XLSX 내보내기를 구현합니다
02
IFlexGridXlsxOptions 의 includeColumnHeaders , includeStyles , sheetName 옵션으로 출력 형식을 세밀하게 제어합니다
03
formatItem 콜백의 XlsxFormatItemEventArgs.xlsxCell 로 셀 단위 배경색과 글꼴을 동적으로 지정합니다
04
includeColumns 콜백으로 특정 열만 골라 내보내기에서 제외할 수 있습니다
05
대용량 데이터는 saveAsync() 로 비동기 처리하고 onProgress 콜백으로 진행률을 표시할 수 있습니다

FlexGridXlsxConverter로 브라우저에서 XLSX를 만드는 원리

FlexGridXlsxConverter 는 @mescius/wijmo.grid.xlsx 패키지(CDN: wijmo.grid.xlsx.min.js )에 포함된 정적 클래스입니다. 내부적으로 XLSX 파일 생성을 담당하는 wijmo.xlsx 모듈과 ZIP 처리 라이브러리 JSZip에 의존하므로, 세 가지 스크립트를 모두 로드해야 동작합니다.

모듈 역할
jszip.min.js XLSX(ZIP) 파일 생성 기반
wijmo.xlsx.min.js 범용 XLSX 읽기/쓰기
wijmo.grid.xlsx.min.js FlexGrid ↔ XLSX 변환

주요 메서드는 두 가지입니다.

  • save(grid, options?, fileName?) — 동기 방식, JSZip 2.5 기반. 즉시 XLSX 파일을 생성·다운로드하며 반환값( Workbook )으로 추가 가공도 가능합니다.
  • saveAsync(grid, options?, fileName?, onSaved?, onError?, onProgress?) — 비동기 방식, JSZip 3.x 기반. 수십만 행 대용량 데이터에 적합하고 진행률 콜백을 제공합니다.

이 글에서는 소·중규모 데이터에 적합한 동기 방식 save() 를 사용합니다.

💡 SUMMARY
Wijmo FlexGrid는 FlexGridXlsxConverter.save()로 서버 없이 브라우저에서 바로 Excel을 내보낼 수 있습니다.

예제 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에 반영됩니다.

💡 SUMMARY
Wijmo는 셀 서식·병합·열 너비를 유지한 XLSX 내보내기를 기본 제공하며 React·Vue에서도 동작합니다.

예제 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 콜백 모두에서 동일하게 적용됩니다.

💡 SUMMARY
FlexGrid의 formatItem 이벤트로 화면 셀에, FlexGridXlsxConverter 의 formatItem 콜백으로 Excel 셀에 각각 조건부 서식을 적용하면 화면과 내보내기 결과의 스타일을 일치시킬 수 있습니다.

Excel 내보내기 옵션 한눈에 보기

IFlexGridXlsxOptions 인터페이스의 핵심 옵션을 정리합니다.

옵션 기본값 설명
includeColumnHeaders true 열 헤더를 첫 행으로 포함
includeRowHeaders false 행 번호(행 헤더) 포함 여부
includeStyles true 그리드 셀의 스타일을 XLSX 셀 서식으로 반영
sheetName undefined 출력 시트 이름 지정
formatItem undefined 셀 단위 커스터마이징 콜백
includeColumns undefined 특정 열 제외 콜백 ( column => boolean )
quickCellStyles true 셀 스타일 캐싱으로 대량 내보내기 속도 향상

includeColumns 를 활용하면 특정 열을 내보내기에서 선택적으로 제외할 수 있습니다.

save() 메서드는 Workbook 객체를 반환하므로, 시트 이름 변경이나 다중 시트 구성 같은 추가 가공 후 book.save(fileName) 을 직접 호출하는 패턴도 가능합니다.

💡 SUMMARY
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급 기능 없이도 동급 수준을 제공합니다.

💡 SUMMARY
AG Grid Community는 XLSX 내보내기가 Enterprise 전용이지만, Wijmo는 단일 라이선스로 Excel 내보내기를 포함한 모든 그리드 기능을 제공합니다.

자주 묻는 질문 (FAQ)

Q01

Wijmo FlexGrid 데이터를 Excel(XLSX) 파일로 내보내려면 어떻게 하나요?

wijmo.xlsx , wijmo.grid.xlsx , jszip 세 모듈을 로드한 뒤 wijmo.grid.xlsx.FlexGridXlsxConverter.save(grid, { includeColumnHeaders: true }, 'output.xlsx') 를 호출합니다. 서버 없이 브라우저에서 바로 XLSX 파일이 생성·다운로드되며, 열 너비·숫자 형식·날짜 형식이 그리드에 보이는 그대로 반영됩니다.
Q02

FlexGridXlsxConverter는 무엇이고 어떤 메서드를 제공하나요?

@mescius/wijmo.grid.xlsx 패키지에 포함된 정적 클래스로, FlexGrid 인스턴스를 XLSX Workbook 객체로 변환합니다. save() (동기, JSZip 2.x)와 saveAsync() (비동기, JSZip 3.x) 두 메서드를 제공하며, 셀 서식·열 너비·헤더가 포함된 XLSX를 생성합니다. 반환된 Workbook 객체로 시트 이름 변경, 다중 시트 구성 같은 추가 가공도 가능합니다.
Q03

서버 없이 브라우저에서 Excel 파일을 만들 수 있는 JavaScript 그리드 라이브러리는 무엇인가요?

Wijmo의 FlexGridXlsxConverter 가 대표적입니다. JSZip과 Wijmo xlsx 모듈이 브라우저 메모리 안에서 XLSX 파일 구조를 직접 만들기 때문에 백엔드 API 호출 없이 클라이언트에서 완전한 Excel 파일을 내보낼 수 있습니다. 네트워크 상태와 무관하게 동작한다는 점도 장점입니다.
Q04

셀 서식과 병합을 유지한 채 XLSX로 내보낼 수 있는 그리드 컴포넌트는 무엇인가요?

Wijmo FlexGrid의 FlexGridXlsxConverter 는 그리드 데이터를 XLSX 파일로 내보내는 기능을 제공합니다. includeStyles: true 옵션은 기본값으로, FlexGrid 셀에 적용된 지원 가능한 스타일을 XLSX 셀 서식에 반영합니다. 또한 병합된 셀과 그리드의 열 너비가 XLSX 파일에 반영되며, formatItem 콜백을 사용하면 셀별 배경색, 글꼴, 값 등 내보내기 결과를 추가로 조정할 수 있습니다.
Q05

대용량 데이터를 서버 없이 Excel로 내보내려면 어떻게 하나요?

Wijmo의 FlexGridXlsxConverter.saveAsync() 는 JSZip 3.x 기반 비동기 방식으로 대용량 데이터를 처리합니다. onProgress 콜백으로 진행률 표시를 구현할 수 있고, batchSize 파라미터로 행 단위 배치 크기를 조절해 메모리 부담을 줄일 수 있어 수만 행 이상의 데이터에도 적합합니다.

MESCIUS Wijmo

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

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

Wijmo 무료 체험판 다운로드