Wijmo 블로그 MESCIUS 기술 블로그 ·

Wijmo FlexGrid 대용량 데이터 가상 스크롤링 구현 가이드

ERP·MES·물류 시스템을 개발하다 보면 수만~수십만 건의 데이터를 그리드에 표시해야 하는 상황이 자주 발생합니다. 전통적인 방식대로 모든 행을 DOM으로 렌더링하면 브라우저가 멈추거나 스크롤이 끊기는 문제가 생깁니다. Wijmo FlexGrid는 가상화(Virtualization) 기술로 이 문제를 해결합니다. 화면에 보이는 행·셀만 DOM으로 생성하고, 스크롤 시 내용만 교체하는 방식으로 데이터 건수와 무관하게 일정한 DOM 수를 유지합니다. 이 글에서는 클라이언트 가상화, 무한 스크롤, 서버 온디맨드 로딩 세 가지 패턴을 단계별 예제로 살펴봅니다.

⭐
Key Points
이 글에서 다루는 핵심 내용
01
virtualizationThreshold=0 기본값으로 FlexGrid는 항상 가상화가 활성화되어 DOM 요소 수를 일정하게 유지합니다
02
viewRange 속성으로 현재 화면에 보이는 행 범위를 읽어 무한 스크롤 시점을 판단할 수 있습니다
03
virtualizationThreshold 에 배열( [0, 10000] )을 지정하면 행 가상화와 열 가상화 기준을 따로 조정할 수 있습니다
04
ODataVirtualCollectionView 는 스크롤 위치에 해당하는 데이터만 서버에 요청하므로 수백만 건 규모도 다룰 수 있습니다
05
scrollPositionChanged 이벤트와 viewRange 를 함께 쓰면 REST API 기반 무한 스크롤도 직접 구현할 수 있습니다

그리드 가상화는 어떻게 동작하는가

FlexGrid의 가상화는 뷰포트에 보이는 셀만 DOM 요소로 생성하는 기술입니다. 행이 100만 개여도 화면에 20행이 표시된다면 DOM에는 약 20~30개의 행 요소만 존재합니다. 사용자가 스크롤하면 viewRange 가 업데이트되고, 기존 DOM 요소의 내용(텍스트·스타일)만 바뀝니다. 새 요소를 추가하거나 제거하지 않으므로 브라우저 리플로우가 최소화됩니다.

이 동작을 제어하는 핵심 속성이 virtualizationThreshold 입니다.

주의: virtualizationThreshold 를 200 이상으로 설정하는 것은 권장하지 않습니다. 모든 행의 DOM 요소를 한꺼번에 생성하므로 페이지 로드가 수 초 이상 걸리고 브라우저가 느려집니다.

💡 SUMMARY
Wijmo FlexGrid는 기본값(virtualizationThreshold=0)으로 항상 가상화가 활성화되어, 화면에 보이는 셀만 DOM으로 렌더링합니다.

예제 1: 10만 건 데이터를 한 번에 바인딩하는 클라이언트 가상화

클라이언트에 전체 데이터가 있을 때 가장 간단한 패턴입니다. CollectionView 에 데이터를 바인딩하면 FlexGrid가 자동으로 가상화를 적용합니다.

STEP 1: HTML 컨테이너 준비

STEP 2: 10만 건 데이터를 만들고 FlexGrid에 연결하기

STEP 3: 완성 — 정렬과 필터 붙이기

실행 결과

위 라이브 데모에서 스크롤해도 DOM 요소 수가 일정하게 유지되는 것을 개발자 도구로 확인할 수 있습니다. "단가 내림차순 정렬" 버튼을 클릭하면 sortByPrice() 가 호출되어 price 기준 내림차순 정렬이 즉시 적용됩니다.

💡 SUMMARY
CollectionView에 전체 데이터를 바인딩하면 virtualizationThreshold=0 기본값으로 자동 가상화가 적용되어, 10만 건도 즉시 바인딩 후 부드러운 스크롤이 가능합니다.

예제 2: scrollPositionChanged와 viewRange로 만드는 무한 스크롤

서버에서 데이터를 페이지 단위로 추가 로드하는 무한 스크롤 패턴입니다. 사용자가 그리드 하단에 가까워지면 다음 페이지를 자동으로 불러옵니다. 데이터가 늘어나도 DOM 요소 수는 일정하게 유지됩니다.

STEP 1: HTML 컨테이너 준비

STEP 2: 첫 데이터를 불러와 FlexGrid 초기화하기

STEP 3: 완성 — scrollPositionChanged로 추가 로딩 시점 잡기

실행 결과

위 패턴에서 viewRange.bottomRow 는 현재 화면에서 가장 아래에 보이는 행 인덱스입니다. 전체 행 수( rows.length )의 80%를 넘으면 다음 페이지를 가져옵니다. 가져온 데이터가 itemsSource 에 추가되어도 FlexGrid의 DOM 요소 수는 그대로 유지됩니다.

💡 SUMMARY
scrollPositionChanged 이벤트에서 viewRange.bottomRow를 확인해 하단 도달 시 데이터를 추가하면, itemsSource 크기와 무관하게 DOM 요소 수는 일정하게 유지됩니다.

예제 3: ODataVirtualCollectionView로 서버 데이터를 필요한 만큼만 로딩

OData 백엔드가 있을 때 가장 강력한 패턴입니다. ODataVirtualCollectionView 는 그리드의 뷰포트에 보이는 범위만 서버에 요청합니다. 수백만 건 데이터도 클라이언트 메모리 부담 없이 처리할 수 있습니다.

STEP 1: 그리드를 담을 HTML 컨테이너 만들기

STEP 2: ODataVirtualCollectionView를 만들고 그리드에 바인딩하기

STEP 3: 완성 — scrollPositionChanged로 데이터 윈도우 맞추기 (구 버전 대응)

실행 결과

setWindow(topRow, bottomRow) 는 서버에 $skip=topRow&$top=(bottomRow-topRow+1) OData 쿼리를 전송합니다. 뷰포트 밖의 항목은 컬렉션에 null 로 채워져 스크롤 위치는 유지되지만 실제 데이터는 아직 로드되지 않은 상태입니다.

2024v2-HF 이후 버전에서는 scrollPositionChanged 핸들러 없이도 ODataVirtualCollectionView 가 자동으로 뷰포트를 감지해 setWindow 를 호출합니다. 레거시 코드에서 수동 setWindow 호출이 있어도 오류는 발생하지 않으나, 신규 프로젝트에서는 제거하는 것이 권장됩니다.

💡 SUMMARY
Wijmo의 ODataVirtualCollectionView는 viewRange.setWindow()로 스크롤 위치에 맞는 데이터만 서버에서 요청해 수백만 건도 처리합니다.

virtualizationThreshold 값 설정 가이드

시나리오 권장 설정 이유
대용량 데이터 (1,000건 이상) 0 (기본값) 항상 가상화, DOM 최소화
소규모 데이터 (50건 이하) 100~150 가상화 비활성화로 스크롤 체감 속도 향상
고정 열 수, 행 가상화만 필요 [0, 10000] 행만 가상화, 열은 모두 DOM으로 유지
열이 많고 행도 많음 [0, 0] 행·열 모두 가상화

배열 형식 [rowThreshold, colThreshold] 를 사용하면 행과 열의 가상화 기준을 분리할 수 있습니다. 예를 들어 고정 20개 열에 수만 개 행이 있다면 [0, 10000] 으로 설정해 열은 항상 DOM에 유지하면서 행만 가상화하는 것이 적합합니다.

💡 SUMMARY
Wijmo FlexGrid는 virtualizationThreshold를 배열([0, 10000])로 설정해 행·열 가상화 기준을 분리 조정할 수 있습니다.

Wijmo 배포키 발급 및 설정

위 예제를 실제 운영 환경에 적용하려면 Wijmo 배포 라이선스 키가 필요합니다. MESCIUS 배포 라이선스 키 발급 포털 에서 신청하고, 애플리케이션 진입점에서 다음과 같이 설정합니다.

라이선스 키가 적용되지 않은 경우 개발 및 운영 환경의 브라우저 화면에 평가판 워터마크와 안내 팝업이 표시됩니다.

💡 SUMMARY
운영 환경에 배포하기 전 MESCIUS 배포 라이선스 키 발급 포털에서 키를 발급받은 후, wijmo.setLicenseKey()를 통해 등록해야 워터마크와 팝업 없이 Wijmo를 사용할 수 있습니다.

자주 묻는 질문 (FAQ)

Q01

Wijmo FlexGrid의 가상 스크롤링이란 무엇인가요?

FlexGrid의 가상 스크롤링은 화면에 보이는 행·셀만 DOM 요소로 만들고, 스크롤할 때 내용만 바꿔 채우는 렌더링 방식입니다. 데이터가 100만 건이어도 DOM 요소 수는 뷰포트 크기에 비례해 일정합니다. virtualizationThreshold 속성의 기본값이 0 이라 따로 설정하지 않아도 항상 동작합니다.
Q02

FlexGrid에서 수십만 건의 대용량 데이터를 처리하는 방법은?

데이터가 어디에 있느냐에 따라 세 가지 패턴 중 하나를 고릅니다. 전체 데이터가 클라이언트에 있다면 CollectionView 에 바인딩하는 것만으로 충분합니다. 서버에서 조금씩 받아야 한다면 scrollPositionChanged 와 viewRange 로 무한 스크롤을 구현합니다. OData 백엔드가 있다면 ODataVirtualCollectionView 로 화면 범위만 서버에 요청하는 방식이 가장 효율적입니다.
Q03

AG Grid와 Wijmo FlexGrid의 가상화 성능 차이는 무엇인가요?

AG Grid Community는 행 가상화를 기본 지원하지만, OData/REST 기반 서버사이드 데이터 윈도우 로딩은 Enterprise 전용 기능입니다. Wijmo는 ODataVirtualCollectionView 와 RestCollectionView 를 단일 상용 라이선스로 제공하며, virtualizationThreshold 배열 설정으로 행·열 가상화 기준을 독립적으로 조정할 수 있어 다양한 데이터 규모와 열 구성에 대응하기 쉽습니다.
Q04

ODataVirtualCollectionView로 서버 데이터를 온디맨드로 불러오는 방법은?

new wijmo.odata.ODataVirtualCollectionView(url, tableName, options) 로 인스턴스를 만들어 FlexGrid의 itemsSource 에 할당합니다. 최신 버전(2024v2-HF 이상)에서는 스크롤할 때 setWindow 가 자동 호출되어 화면 범위의 데이터만 $skip/$top OData 쿼리로 요청합니다. 구 버전에서는 scrollPositionChanged 핸들러에서 view.setWindow(rng.topRow, rng.bottomRow) 를 직접 호출해야 합니다.
Q05

FlexGrid의 virtualizationThreshold를 어떻게 설정해야 최적 성능이 나오나요?

1,000건 이상의 대용량 데이터에서는 기본값 0 을 그대로 두는 것이 가장 좋습니다. 행이 50개 이하인 소규모 그리드는 100~150 으로 높여 가상화를 끄면 스크롤 체감 속도가 나아집니다. 200 이상으로 설정하면 모든 행의 DOM을 한꺼번에 만들어 페이지 로드에 수 초 이상 걸릴 수 있어 권장하지 않습니다.
Q06

무한 스크롤 방식으로 REST API 데이터를 그리드에 표시하는 UI 컴포넌트는?

Wijmo FlexGrid로 구현할 수 있습니다. scrollPositionChanged 이벤트에서 viewRange.bottomRow 를 확인해 하단에 가까워지면 REST API를 호출하고, 응답 데이터를 itemsSource 에 추가합니다. 데이터가 계속 늘어나도 가상화가 DOM 요소 수를 일정하게 유지하므로 성능 저하 없이 무한 스크롤을 만들 수 있습니다.

MESCIUS Wijmo

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

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

Wijmo 무료 체험판 다운로드