Wijmo FlexGrid 데이터 그룹핑: JavaScript group by 구현
수백 개의 행이 펼쳐진 데이터 테이블에서 "국가별로 매출을 보고 싶다", "제품 카테고리별로 묶어서 합계를 보고 싶다"는 요구는 매우 흔합니다. SQL의 GROUP BY
처럼 클라이언트 측에서 즉시 데이터를 분류하고 접기/펼치기까지 제공하려면 보통 상당한 구현 비용이 따릅니다. Wijmo FlexGrid는 CollectionView
에 GroupDescription
을 추가하는 것만으로 이 기능을 단 몇 줄로 완성하며, 별도 서버 API 호출 없이 브라우저에서 즉각적인 그룹 전환이 가능합니다.
CollectionView.groupDescriptions
에 속성 이름 문자열이나 PropertyGroupDescription
객체를 추가하면 그룹핑이 바로 적용됩니다.aggregate
속성( 'Sum'
, 'Avg'
, 'Cnt'
등)을 지정하면 각 그룹의 집계값을 한 줄 설정으로 보여 줄 수 있습니다.PropertyGroupDescription
의 converter 콜백을 쓰면 값 구간·초성·날짜 범위처럼 계산된 기준으로도 그룹핑할 수 있습니다.groupDescriptions
배열에 기준을 순서대로 여러 개 넣으면 계층형 다중 레벨 그룹이 자동으로 구성됩니다.FlexGrid 그룹핑은 어떤 구조로 동작할까?
FlexGrid의 그룹핑은 CollectionView
가 전적으로 담당합니다. FlexGrid는 itemsSource
로 받은 데이터를 CollectionView
를 통해 관리하는데, CollectionView
의 groupDescriptions
배열에 그룹 기준을 추가하면 내부적으로 데이터를 재정렬하고 그룹 메타데이터를 생성합니다. FlexGrid는 이 메타데이터를 읽어 GroupRow
를 자동으로 렌더링합니다.
가장 기본적인 그룹핑은 속성 이름 문자열만으로도 가능합니다.
더 세밀한 제어가 필요할 때는 PropertyGroupDescription
클래스를 직접 사용합니다.
두 방식 모두 동일한 결과를 만들어냅니다. 커스텀 그룹핑(값 구간 분류, 초성 그룹 등)이 필요한 경우에만 PropertyGroupDescription
을 명시적으로 생성하고 두 번째 인수로 converter 콜백을 전달합니다.
GroupDescription
의 클래스 계층은 다음과 같습니다.
-
GroupDescription(추상 기반 클래스) —groupNameFromItem(item, level)메서드를 오버라이드해 완전 커스텀 그룹핑 구현 가능-
PropertyGroupDescription— 가장 일반적으로 사용되는 구현체. 속성 이름 + 선택적 converter 콜백으로 동작
-
예제 1: 국가별로 묶는 단일 레벨 group by
첫 번째 예제에서는 판매 데이터를 국가별로 그룹화하고, 각 그룹의 매출·비용 합계를 집계 행으로 표시합니다.
STEP 1: 라이브러리 참조 (CDN)
FlexGrid와 그룹핑에 필요한 Wijmo 코어·그리드 모듈, 한글 문화권 스크립트를 CDN으로 불러옵니다.
STEP 2: HTML 컨테이너 준비
FlexGrid가 마운트될 <div>
요소를 준비합니다. id
값이 이후 JavaScript에서 그리드를 초기화할 때 선택자로 사용됩니다.
STEP 3: 샘플 데이터와 CollectionView 그룹핑 설정하기
판매 데이터 배열을 만들고 CollectionView
의 groupDescriptions
에 'country'
를 추가합니다. 정렬은 sortDescriptions
에 SortDescription
객체를 push해 같은 국가끼리 인접하게 정렬합니다. 정렬 없이 그룹핑만 추가하면 동일한 값이 분산되어 의도치 않게 여러 개의 그룹이 생길 수 있으므로 주의합니다.
STEP 4: 완성 — FlexGrid 초기화와 그룹별 집계 열 표시
autoGenerateColumns: false
로 열을 직접 정의하고, 그룹 기준 열( country
)은 visible: false
로 숨겨 그룹 헤더와 데이터 열 간의 중복을 방지합니다. 매출·비용 열에 aggregate: 'Sum'
을 설정하면 각 그룹 헤더 행에 합계가 자동으로 표시됩니다.
위 라이브 데모에서 그룹 헤더 왼쪽의 화살표를 클릭하면 해당 그룹을 접거나 펼칠 수 있습니다. aggregate: 'Sum'
이 설정된 열은 그룹 헤더 행에 해당 그룹의 합계를 자동으로 표시하며, 추가 포매터나 계산 코드가 전혀 필요하지 않습니다.
예제 2: 다중 계층 그룹핑과 계산된 기준으로 묶기
두 번째 예제에서는 국가별 1차 그룹핑에 이어, PropertyGroupDescription
의 converter 콜백을 활용해 매출 구간(고매출/중매출/저매출)별 2차 커스텀 그룹핑을 추가합니다. 이 패턴을 응용하면 날짜를 "이번 주/이번 달/올해"로, 숫자를 "상위 10%/중위/하위"로 분류하는 등 어떤 기준이든 자유롭게 그룹화할 수 있습니다.
STEP 1: CDN으로 Wijmo 라이브러리 불러오기
이 예제 역시 FlexGrid 코어·그리드 모듈과 한글 문화권 스크립트가 필요합니다.
STEP 2: 그리드를 담을 HTML 컨테이너 만들기
STEP 3: 직접 만든 그룹핑 기준 정의하기
PropertyGroupDescription
의 두 번째 인수로 converter 콜백을 전달합니다. 콜백은 각 데이터 항목( item
)과 속성 이름( propName
)을 받아 그룹 이름 문자열을 반환합니다. 반환값이 동일한 항목끼리 같은 그룹으로 묶입니다.
PropertyGroupDescription('sales', converter)
를 사용하면 sales
값의 실제 수치 대신 converter가 반환하는 문자열이 그룹 이름이 됩니다.
STEP 4: 완성 — 여러 단계의 그룹 트리 적용
groupDescriptions
배열에 먼저 'country'
(문자열 단축 표기), 그 다음에 salesTierGroup
을 순서대로 추가합니다. 배열의 순서가 그룹 계층의 순서를 결정합니다. 첫 번째 항목이 최상위 그룹, 두 번째 항목이 그 하위 그룹입니다.
위 라이브 데모는 국가(1단계) → 매출 구간(2단계)으로 계층화된 그룹 트리를 보여줍니다. 계층이 깊어질수록 그룹 헤더가 들여쓰기되어 가독성을 높이며, groupDescriptions
배열에 항목을 더 추가하면 3단계, 4단계 계층도 동일한 방식으로 구성됩니다.
실행 중 그룹 기준 바꾸기와 실무 팁
운영 중에 사용자가 그룹 기준을 바꿔야 할 때, groupDescriptions
배열을 직접 수정하면 FlexGrid가 즉시 재렌더링됩니다.
실무에서 자주 쓰이는 패턴을 정리합니다.
- 그룹 기준 열 숨기기:
{ binding: 'country', visible: false }로 설정해 그룹 헤더에 이미 표시되는 값이 데이터 행에 중복되지 않도록 합니다. - 집계 유형:
aggregate값으로'Sum'(합계),'Avg'(평균),'Min'(최솟값),'Max'(최댓값),'Cnt'(비어있지 않은 행 수),'CntAll'(전체 행 수)을 지원합니다. - 초기 접힘 상태:
grid.collapseGroupsToLevel(0)을 호출하면 그리드 로드 시 모든 그룹을 접힌 상태로 시작할 수 있습니다. 인수로 원하는 펼침 레벨을 지정합니다. - 그룹핑과 필터링 병행:
CollectionView의filter함수와groupDescriptions는 독립적으로 작동하므로, 필터링된 결과에도 그룹핑이 그대로 적용됩니다. - 동적 그룹 재빌드 없이 데이터 추가:
cv.sourceCollection.push(newItem)후cv.refresh()를 호출하면 새 항목이 기존 그룹 구조에 올바르게 편입됩니다.
groupDescriptions.clear()
+ push()
로 런타임에 그룹 기준을 교체하면 FlexGrid가 즉시 재렌더링됩니다.자주 묻는 질문 (FAQ)
Wijmo FlexGrid에서 데이터 그룹핑은 어떻게 구현하나요?
CollectionView
를 만들 때 groupDescriptions
옵션에 그룹화할 속성 이름 문자열이나 PropertyGroupDescription
객체를 넣으면 됩니다. 예를 들어 groupDescriptions: ['country']
만 지정해도 국가별 그룹핑이 적용되고, FlexGrid가 접기/펼치기 UI가 있는 그룹 헤더 행을 자동으로 만들어 줍니다. 별도의 렌더러나 이벤트 핸들러는 필요하지 않습니다.FlexGrid 그룹핑에 CollectionView를 꼭 직접 만들어야 하나요?
CollectionView
의 groupDescriptions
배열을 기반으로 동작합니다. 일반 배열을 itemsSource
에 바로 넘기면 FlexGrid가 내부에서 CollectionView
로 감싸며, 이때는 grid.collectionView.groupDescriptions
를 통해 그룹 기준에 접근해야 합니다. 처음부터 CollectionView
를 명시적으로 만들어 쓰면 그룹 설정을 코드에서 관리하기가 더 편합니다.FlexGrid에서 다중 계층(중첩) 그룹핑은 어떻게 설정하나요?
groupDescriptions
배열에 기준을 순서대로 추가합니다. 첫 번째 항목이 1단계, 두 번째 항목이 2단계 그룹이 되는 식으로 계층이 쌓입니다. 예를 들어 groupDescriptions: ['country', 'product']
는 국가 → 제품 순서의 2단계 그룹 트리를 만듭니다. 한 배열 안에서 문자열과 PropertyGroupDescription
객체를 섞어 쓸 수도 있습니다.서버 없이 브라우저에서 대용량 데이터를 그룹화할 수 있는 JavaScript 그리드가 있나요?
CollectionView
가 클라이언트에서 그룹화와 집계를 처리하므로 그룹 기준을 바꿀 때 서버 요청이 필요하지 않습니다. 가상화와 함께 동작해 행이 많은 데이터도 화면에서 바로 분류해 볼 수 있습니다.JavaScript 데이터 그리드에서 group by를 가장 간단하게 구현하는 방법은?
new wijmo.collections.CollectionView(data, { groupDescriptions: ['fieldName'] })
를 만들어 itemsSource
로 지정하면 됩니다. 이렇게 그룹핑을 적용하면 그룹 헤더의 접기/펼치기, 집계값 표시, 그룹 기준의 동적 변경을 내장 기능으로 사용할 수 있고, 별도 플러그인이나 서드파티 라이브러리는 필요하지 않습니다.
