Wijmo FlexGrid 데이터 바인딩: itemsSource·CollectionView 입문
엔터프라이즈 웹 애플리케이션에서 데이터 그리드는 핵심 UI 컴포넌트 중 하나입니다.
itemsSource
에 배열을 그대로 할당해 FlexGrid에 데이터를 연결하는 가장 간단한 방법CollectionView
로 정렬·필터링·페이징을 서버 호출 없이 클라이언트에서 처리하는 방법SortDescription
으로 다중 열 정렬을 구현하고 그리드 내부 CollectionView에 접근하는 패턴collectionChanged
이벤트로 화면이 자동 갱신되는 원리이 가이드에서는 FlexGrid의 핵심 개념인 데이터 바인딩을 집중적으로 다룹니다. 배열을 직접 바인딩하는 가장 빠른 방법부터, CollectionView
를 활용한 고급 데이터 관리까지 실전 코드와 함께 단계별로 살펴봅니다.
자바스크립트 데이터 그리드, FlexGrid로 시작하기
FlexGrid는 Wijmo 라이브러리의 핵심 그리드 컨트롤로, 일반 JavaScript 배열부터 REST API 응답 데이터까지 다양한 소스를 손쉽게 바인딩할 수 있습니다. 내부적으로는 CollectionView
라는 데이터 래퍼 객체를 통해 모든 데이터 조작이 이루어지는 구조입니다.
Wijmo의 데이터 흐름은 다음과 같이 설명할 수 있습니다.
배열을 itemsSource
에 직접 할당하면 FlexGrid가 내부적으로 CollectionView를 자동 생성합니다. 따라서 간단한 시나리오에서는 CollectionView를 직접 생성하지 않아도 됩니다. 하지만 정렬·필터링·그룹핑·페이징 같은 고급 기능을 활용하려면 CollectionView를 명시적으로 사용하는 것이 훨씬 유리합니다.
데이터 → CollectionView → 화면
이라는 단방향 데이터 흐름을 가지며, 배열 직접 바인딩과 CollectionView 명시적 사용 두 가지 방식을 모두 지원합니다.CDN 스크립트 몇 줄로 FlexGrid 화면에 띄우기
별도의 빌드 환경 없이 CDN만으로 FlexGrid를 페이지에 추가할 수 있습니다. 다음 세 줄만 HTML <head>
에 추가하면 됩니다.
그런 다음 그리드가 마운트될 호스트 요소를 HTML <body>
에 추가합니다.
id
속성은 JavaScript에서 FlexGrid를 초기화할 때 CSS 선택자로 사용됩니다. height
를 지정하지 않으면 그리드가 화면에 보이지 않을 수 있으므로 반드시 높이를 설정하세요.
https://cdn.mescius.com/wijmo/5.latest/
를 기준으로 CSS 1개와 JS 2개(core + grid)를 로드하면 FlexGrid를 즉시 사용할 수 있습니다.배열을 그리드에 연결하는 가장 쉬운 방법: itemsSource
가장 간단한 바인딩 방법은 JavaScript 배열을 FlexGrid의 itemsSource
속성에 직접 할당하는 것입니다. FlexGrid는 배열을 받으면 자동으로 내부 CollectionView를 생성하여 정렬·편집 기능을 활성화합니다.
아래 예제는 국가별 매출 데이터를 FlexGrid에 바인딩하는 전형적인 패턴입니다.
이 코드에서 핵심 속성을 살펴봅니다.
-
autoGenerateColumns: false: 기본값은true로, 데이터 객체의 모든 프로퍼티를 자동으로 열로 생성합니다.false로 설정하면columns배열에 정의한 열만 표시됩니다. 실제 애플리케이션에서는 대부분false로 설정하여 원하는 열만 제어합니다. -
binding: 데이터 객체의 프로퍼티 이름입니다. 데이터의country프로퍼티를 이 열에 연결합니다. -
header: 열 헤더에 표시할 텍스트입니다. -
width: 픽셀 숫자 또는'*'(별) 표기를 사용합니다.'2*'는'*'열의 두 배 너비를 의미하는 비율 방식입니다. -
format:'n0'은 소수점 없는 숫자,'n2'는 소수점 두 자리 숫자 포맷입니다. Wijmo의Globalize포맷 문자열을 사용합니다. -
itemsSource: 데이터 소스입니다. 배열 또는ICollectionView구현체를 받습니다.
itemsSource
에 배열을 할당하면 FlexGrid가 내부 CollectionView를 자동 생성하며, autoGenerateColumns: false
와 columns
배열로 표시할 열을 직접 제어할 수 있습니다.CollectionView로 정렬·필터·페이징 다루기
배열을 직접 바인딩하면 편리하지만, 정렬·필터링·페이징 같은 고급 기능이 필요할 때는 ** CollectionView
**를 명시적으로 생성하여 사용하는 것이 훨씬 강력합니다. CollectionView는 원본 배열을 감싸서 다양한 뷰(View)를 제공하는 데이터 래퍼입니다.
열 정렬을 코드로 지정하기
CollectionView의 핵심 API를 정리하면 다음과 같습니다.
그리드가 만든 CollectionView 꺼내 쓰기
배열을 itemsSource
에 직접 바인딩한 경우에도, FlexGrid의 collectionView
속성으로 자동 생성된 내부 CollectionView에 접근할 수 있습니다.
filter
함수와 sortDescriptions
으로 런타임에도 자유롭게 뷰를 변경할 수 있습니다.데이터가 바뀔 때 그리드 화면이 갱신되는 원리
FlexGrid는 데이터 변경을 어떻게 감지할까요? 답은 CollectionView의 변경 알림(Change Notification) 메커니즘에 있습니다.
배열 원소를 직접 수정하거나 push
/ splice
를 사용하면 FlexGrid는 변경을 자동 감지하지 못합니다. 대신 다음 세 가지 패턴을 사용해야 합니다.
패턴 1: sourceCollection
을 새 배열로 교체
패턴 2: deferUpdate
로 일괄 업데이트
여러 항목을 한꺼번에 추가할 때 deferUpdate
를 사용하면 업데이트를 한 번만 실행하여 성능을 최적화할 수 있습니다.
패턴 3: itemsSource
재할당
가장 단순한 방법으로, 새 배열을 itemsSource
에 다시 할당합니다.
sourceCollection
교체, deferUpdate
일괄 업데이트, itemsSource
재할당 세 가지 패턴을 사용합니다. 원본 배열을 직접 변경(push, splice 등)하는 방식은 자동 갱신이 보장되지 않습니다.npm 프로젝트에서 FlexGrid 모듈 가져오기
React, Vue, Angular 같은 모던 프레임워크 환경에서는 CDN 대신 npm 패키지를 사용합니다. FlexGrid 관련 패키지 구조는 다음과 같습니다.
설치 명령:
ES 모듈 임포트 방식:
CDN을 사용하는 경우 wijmo
와 wijmo.grid
가 전역 네임스페이스에 로드되므로 wijmo.grid.FlexGrid
, wijmo.CollectionView
처럼 접근합니다. npm 모듈 방식에서는 임포트한 객체를 직접 사용합니다.
@mescius/wijmo
(코어)와 @mescius/wijmo.grid
(FlexGrid)를 설치하고 ES 모듈 임포트로 사용합니다. CDN 방식에서는 순서대로 스크립트를 로드하면 전역 네임스페이스에서 접근할 수 있습니다.따라 해보기: 매출 대시보드 그리드 만들기
지금까지 배운 내용을 종합하여 필터링과 정렬이 가능한 매출 대시보드 그리드를 만들어 봅니다.
이 예제에서 추가된 속성들을 확인합니다.
-
selectionMode: wijmo.grid.SelectionMode.Row: 셀 단위가 아닌 행 전체를 선택합니다. -
alternatingRowStep: 1: 줄무늬 행(zebra striping) 스타일을 활성화합니다. -
isReadOnly: true(열 레벨): 특정 열을 편집 불가로 설정합니다.
filter
함수는 런타임에 언제든지 교체할 수 있으며, null
로 설정하면 필터가 즉시 해제됩니다. 이를 UI 이벤트와 연결하면 손쉽게 동적 필터링을 구현할 수 있습니다.자주 묻는 질문 (FAQ)
Wijmo FlexGrid에서 데이터를 어떻게 바인딩하나요?
itemsSource
속성에 JavaScript 배열 또는 CollectionView
객체를 할당하면 됩니다. 배열을 직접 할당하면 FlexGrid가 내부적으로 CollectionView를 자동 생성하므로, 정렬·편집 같은 기본 기능을 바로 사용할 수 있습니다.CollectionView란 무엇이며 왜 사용하나요?
sortDescriptions
), 필터링( filter
), 그룹핑( groupDescriptions
), 페이징( pageSize
) 기능을 제공하는 데이터 래퍼 클래스입니다. 단순 배열 바인딩보다 CollectionView를 명시적으로 사용하면 데이터 뷰를 훨씬 정교하게 제어할 수 있습니다. Wijmo의 모든 UI 컨트롤(FlexGrid, FlexChart 등)이 CollectionView를 공통 데이터 계층으로 사용하므로, 같은 CollectionView를 여러 컨트롤에 바인딩하면 하나의 뷰 변경이 모든 컨트롤에 동기화됩니다.FlexGrid에 배열 데이터를 직접 바인딩할 수 있나요?
itemsSource: myArray
처럼 배열을 직접 할당하면 FlexGrid가 내부 CollectionView를 생성해 사용합니다. 이 내부 CollectionView에는 theGrid.collectionView
속성으로 접근할 수 있습니다.FlexGrid 열(Column)은 어떻게 정의하나요?
autoGenerateColumns: false
로 설정한 뒤 columns
배열에 각 열의 설정 객체를 정의합니다. 각 객체에는 binding
(데이터 프로퍼티명), header
(헤더 텍스트), width
(너비), format
(표시 형식) 등의 속성을 지정할 수 있습니다. width
에는 픽셀 값( 120
) 또는 별(*) 비율 표기( '2*'
)를 사용할 수 있습니다.FlexGrid를 HTML 페이지에 추가하는 가장 빠른 방법은?
https://cdn.mescius.com/wijmo/5.latest/
경로에서 styles/wijmo.min.css
, controls/wijmo.min.js
, controls/wijmo.grid.min.js
세 파일을 로드하고, <div id="theGrid"></div>
호스트 요소를 HTML에 추가한 뒤 JavaScript에서 new wijmo.grid.FlexGrid('#theGrid', { itemsSource: data })
를 호출하면 됩니다.itemsSource 속성에는 어떤 타입을 넣을 수 있나요?
itemsSource
속성은 일반 JavaScript 배열( Array
)과 ICollectionView
인터페이스를 구현한 객체를 모두 허용합니다. 실제로는 CollectionView
, ODataCollectionView
, RestCollectionView
등 CollectionView의 모든 파생 클래스를 바인딩할 수 있습니다.FlexGrid에서 데이터 변경 시 자동으로 화면이 업데이트되나요?
cv.sourceCollection = newArray
로 배열을 교체하거나, cv.deferUpdate()
블록 안에서 변경 작업을 수행하거나, theGrid.itemsSource = newArray
로 재할당해야 합니다.정리
이 가이드에서는 Wijmo FlexGrid의 두 가지 데이터 바인딩 방식을 살펴봤습니다.
- 배열 직접 바인딩:
itemsSource: data로 즉시 시작, 내부 CollectionView 자동 생성 - CollectionView 명시적 사용: 정렬·필터·그룹·페이징을 선언적으로 제어
FlexGrid는 이 외에도 셀 편집, 열 고정(freeze), 가상 스크롤링, Excel/PDF 내보내기 등 엔터프라이즈 수준의 기능을 풍부하게 제공합니다. 다음 글에서는 FlexGrid의 열 필터링과 페이징 기능을 CollectionView와 함께 구현하는 방법을 다룰 예정입니다.
Wijmo FlexGrid에 대한 더 자세한 정보는 MESCIUS 공식 개발자 사이트 에서 확인하세요.
