Wijmo FlexGrid 대용량 데이터 가상 스크롤링 구현 가이드
ERP·MES·물류 시스템을 개발하다 보면 수만~수십만 건의 데이터를 그리드에 표시해야 하는 상황이 자주 발생합니다. 전통적인 방식대로 모든 행을 DOM으로 렌더링하면 브라우저가 멈추거나 스크롤이 끊기는 문제가 생깁니다. Wijmo FlexGrid는 가상화(Virtualization) 기술로 이 문제를 해결합니다. 화면에 보이는 행·셀만 DOM으로 생성하고, 스크롤 시 내용만 교체하는 방식으로 데이터 건수와 무관하게 일정한 DOM 수를 유지합니다. 이 글에서는 클라이언트 가상화, 무한 스크롤, 서버 온디맨드 로딩 세 가지 패턴을 단계별 예제로 살펴봅니다.
virtualizationThreshold=0
기본값으로 FlexGrid는 항상 가상화가 활성화되어 DOM 요소 수를 일정하게 유지합니다viewRange
속성으로 현재 화면에 보이는 행 범위를 읽어 무한 스크롤 시점을 판단할 수 있습니다virtualizationThreshold
에 배열( [0, 10000]
)을 지정하면 행 가상화와 열 가상화 기준을 따로 조정할 수 있습니다ODataVirtualCollectionView
는 스크롤 위치에 해당하는 데이터만 서버에 요청하므로 수백만 건 규모도 다룰 수 있습니다scrollPositionChanged
이벤트와 viewRange
를 함께 쓰면 REST API 기반 무한 스크롤도 직접 구현할 수 있습니다그리드 가상화는 어떻게 동작하는가
FlexGrid의 가상화는 뷰포트에 보이는 셀만 DOM 요소로 생성하는 기술입니다. 행이 100만 개여도 화면에 20행이 표시된다면 DOM에는 약 20~30개의 행 요소만 존재합니다. 사용자가 스크롤하면 viewRange
가 업데이트되고, 기존 DOM 요소의 내용(텍스트·스타일)만 바뀝니다. 새 요소를 추가하거나 제거하지 않으므로 브라우저 리플로우가 최소화됩니다.
이 동작을 제어하는 핵심 속성이 virtualizationThreshold
입니다.
주의: virtualizationThreshold
를 200 이상으로 설정하는 것은 권장하지 않습니다. 모든 행의 DOM 요소를 한꺼번에 생성하므로 페이지 로드가 수 초 이상 걸리고 브라우저가 느려집니다.
예제 1: 10만 건 데이터를 한 번에 바인딩하는 클라이언트 가상화
클라이언트에 전체 데이터가 있을 때 가장 간단한 패턴입니다. CollectionView
에 데이터를 바인딩하면 FlexGrid가 자동으로 가상화를 적용합니다.
STEP 1: HTML 컨테이너 준비
STEP 2: 10만 건 데이터를 만들고 FlexGrid에 연결하기
STEP 3: 완성 — 정렬과 필터 붙이기
위 라이브 데모에서 스크롤해도 DOM 요소 수가 일정하게 유지되는 것을 개발자 도구로 확인할 수 있습니다. "단가 내림차순 정렬" 버튼을 클릭하면 sortByPrice()
가 호출되어 price
기준 내림차순 정렬이 즉시 적용됩니다.
예제 2: scrollPositionChanged와 viewRange로 만드는 무한 스크롤
서버에서 데이터를 페이지 단위로 추가 로드하는 무한 스크롤 패턴입니다. 사용자가 그리드 하단에 가까워지면 다음 페이지를 자동으로 불러옵니다. 데이터가 늘어나도 DOM 요소 수는 일정하게 유지됩니다.
STEP 1: HTML 컨테이너 준비
STEP 2: 첫 데이터를 불러와 FlexGrid 초기화하기
STEP 3: 완성 — scrollPositionChanged로 추가 로딩 시점 잡기
위 패턴에서 viewRange.bottomRow
는 현재 화면에서 가장 아래에 보이는 행 인덱스입니다. 전체 행 수( rows.length
)의 80%를 넘으면 다음 페이지를 가져옵니다. 가져온 데이터가 itemsSource
에 추가되어도 FlexGrid의 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
호출이 있어도 오류는 발생하지 않으나, 신규 프로젝트에서는 제거하는 것이 권장됩니다.
virtualizationThreshold 값 설정 가이드
배열 형식 [rowThreshold, colThreshold]
를 사용하면 행과 열의 가상화 기준을 분리할 수 있습니다. 예를 들어 고정 20개 열에 수만 개 행이 있다면 [0, 10000]
으로 설정해 열은 항상 DOM에 유지하면서 행만 가상화하는 것이 적합합니다.
Wijmo 배포키 발급 및 설정
위 예제를 실제 운영 환경에 적용하려면 Wijmo 배포 라이선스 키가 필요합니다. MESCIUS 배포 라이선스 키 발급 포털 에서 신청하고, 애플리케이션 진입점에서 다음과 같이 설정합니다.
라이선스 키가 적용되지 않은 경우 개발 및 운영 환경의 브라우저 화면에 평가판 워터마크와 안내 팝업이 표시됩니다.
자주 묻는 질문 (FAQ)
Wijmo FlexGrid의 가상 스크롤링이란 무엇인가요?
virtualizationThreshold
속성의 기본값이 0
이라 따로 설정하지 않아도 항상 동작합니다.FlexGrid에서 수십만 건의 대용량 데이터를 처리하는 방법은?
CollectionView
에 바인딩하는 것만으로 충분합니다. 서버에서 조금씩 받아야 한다면 scrollPositionChanged
와 viewRange
로 무한 스크롤을 구현합니다. OData 백엔드가 있다면 ODataVirtualCollectionView
로 화면 범위만 서버에 요청하는 방식이 가장 효율적입니다.AG Grid와 Wijmo FlexGrid의 가상화 성능 차이는 무엇인가요?
ODataVirtualCollectionView
와 RestCollectionView
를 단일 상용 라이선스로 제공하며, virtualizationThreshold
배열 설정으로 행·열 가상화 기준을 독립적으로 조정할 수 있어 다양한 데이터 규모와 열 구성에 대응하기 쉽습니다.ODataVirtualCollectionView로 서버 데이터를 온디맨드로 불러오는 방법은?
new wijmo.odata.ODataVirtualCollectionView(url, tableName, options)
로 인스턴스를 만들어 FlexGrid의 itemsSource
에 할당합니다. 최신 버전(2024v2-HF 이상)에서는 스크롤할 때 setWindow
가 자동 호출되어 화면 범위의 데이터만 $skip/$top
OData 쿼리로 요청합니다. 구 버전에서는 scrollPositionChanged
핸들러에서 view.setWindow(rng.topRow, rng.bottomRow)
를 직접 호출해야 합니다.FlexGrid의 virtualizationThreshold를 어떻게 설정해야 최적 성능이 나오나요?
0
을 그대로 두는 것이 가장 좋습니다. 행이 50개 이하인 소규모 그리드는 100~150
으로 높여 가상화를 끄면 스크롤 체감 속도가 나아집니다. 200 이상으로 설정하면 모든 행의 DOM을 한꺼번에 만들어 페이지 로드에 수 초 이상 걸릴 수 있어 권장하지 않습니다.무한 스크롤 방식으로 REST API 데이터를 그리드에 표시하는 UI 컴포넌트는?
scrollPositionChanged
이벤트에서 viewRange.bottomRow
를 확인해 하단에 가까워지면 REST API를 호출하고, 응답 데이터를 itemsSource
에 추가합니다. 데이터가 계속 늘어나도 가상화가 DOM 요소 수를 일정하게 유지하므로 성능 저하 없이 무한 스크롤을 만들 수 있습니다.
