Wijmo 블로그 MESCIUS 기술 블로그 ·

Wijmo FlexGrid 정렬·필터 구현: 다중 정렬부터 Excel 필터까지

Wijmo FlexGrid는 allowSorting 속성 하나로 단일·다중 열 정렬을 활성화하고, wijmo.grid.filter.FlexGridFilter 클래스 한 줄로 모든 열에 Excel과 동일한 필터 UI를 추가할 수 있습니다. 직접 DOM을 조작하거나 별도의 상태 관리 코드 없이도, 10만 행 이상의 대용량 데이터에서도 즉각적인 정렬·필터링 성능을 제공합니다. 이 글에서는 CDN 기반 순수 JavaScript 환경을 기준으로 기본 정렬부터 다중 열 동시 정렬, 프로그래매틱 정렬 제어, Excel 스타일 필터까지 단계별로 완벽하게 다룹니다.

💡 SUMMARY
이 글의 예제는 모두 CDN 기반 순수 JavaScript(Vanilla JS) 환경 기준입니다. 네임스페이스 형식은 wijmo.grid.filter.FlexGridFilter 처럼 전역 wijmo 객체를 사용합니다. npm/모듈 환경에서는 import { FlexGridFilter } from '@mescius/wijmo.grid.filter' 로 대체하세요.
⭐
Key Points
이 글에서 다루는 핵심 내용
01
allowSorting 속성의 세 가지 값( AllowSorting.None , SingleColumn , MultiColumn )만 바꿔도 그리드의 정렬 동작을 원하는 대로 지정할 수 있다
02
AllowSorting.MultiColumn 만 설정하면 여러 열을 동시에 정렬할 수 있고, 헤더에 정렬 순서 번호가 자동으로 표시된다
03
CollectionView.sortDescriptions 에 SortDescription 객체를 추가하면 버튼 클릭 등 코드에서 원하는 시점에 정렬을 적용할 수 있다
04
wijmo.grid.filter.FlexGridFilter 인스턴스를 하나 만들면 모든 열에 Excel 스타일 필터 아이콘이 붙는다
05
getColumnFilter() 와 FilterType 을 쓰면 특정 열의 정렬·필터만 끄는 식으로 열별 동작을 세밀하게 조절할 수 있다
06
CDN에서 wijmo.culture.ko.min.js 를 불러오면 필터 다이얼로그를 포함한 UI 텍스트가 한국어로 표시된다

자바스크립트 그리드에 열 정렬 기능 추가하기

FlexGrid에서 정렬을 활성화하는 방법은 allowSorting 속성을 지정하는 것입니다. 기본값은 AllowSorting.SingleColumn 으로, 별도 설정 없이 열 헤더 클릭만으로 정렬이 동작합니다.

값 설명
AllowSorting.None 열 헤더 클릭으로 정렬 불가
AllowSorting.SingleColumn 한 번에 한 열만 정렬 (기본값)
AllowSorting.MultiColumn 여러 열 동시 정렬 가능

Step 1: HTML 구조 작성

FlexGrid를 렌더링할 컨테이너 <div> 를 준비합니다. id 속성은 JavaScript에서 그리드를 초기화할 때 사용합니다.

Step 2: 정렬할 샘플 데이터 준비

샘플 데이터를 반환하는 getData() 함수를 작성합니다. 각 항목은 id , country , sales , expenses , active 속성을 갖습니다.

Step 3: FlexGrid 생성과 기본 정렬 확인

wijmo.grid.FlexGrid 생성자에 컨테이너 선택자와 옵션 객체를 전달합니다. allowSorting 으로 그리드 전체의 정렬 동작을 설정하고, 컬럼 정의의 allowSorting: false 로 특정 열만 정렬을 비활성화할 수 있습니다.

열 헤더를 클릭하면 오름차순 → 내림차순으로 정렬됩니다. Ctrl+Click 으로 정렬을 해제할 수 있습니다. 아래 예제에서 국가, 매출, 비용 열 헤더를 클릭해보세요. ID 열은 allowSorting: false 로 정렬이 비활성화됩니다.

실행 결과
💡 SUMMARY
allowSorting 속성으로 그리드 전체 정렬 동작을 결정하고, 컬럼 정의의 allowSorting: false 로 특정 열만 정렬을 비활성화한다.

여러 열을 동시에 정렬하는 다중 정렬 구현 (AllowSorting.MultiColumn)

여러 열을 동시에 정렬하려면 allowSorting 을 wijmo.grid.AllowSorting.MultiColumn 으로 설정합니다. 이 설정 하나만으로 "국가별 → 같은 국가 내 매출 내림차순" 같은 복합 정렬이 가능합니다.

Step 1: HTML 구조 작성

이전 예제와 동일하게 그리드 컨테이너 <div> 를 준비합니다.

Step 2: CSS로 정렬 우선순위 번호 스타일 지정

다중 열 정렬이 활성화되면 헤더에 정렬 우선순위 번호(1, 2, 3...)가 표시됩니다. .wj-cell.wj-header .wj-sort-index 클래스를 재정의하면 이 번호의 스타일을 바꿀 수 있습니다.

실행 결과
💡 SUMMARY
AllowSorting.MultiColumn 설정만으로 다중 열 동시 정렬이 활성화되며, 헤더에 정렬 우선순위 인덱스가 자동으로 표시된다.

코드로 정렬 기준을 지정하는 CollectionView sortDescriptions 활용법

버튼 클릭이나 초기 로드 시점에 프로그래매틱하게 정렬을 적용하려면, CollectionView.sortDescriptions 에 SortDescription 객체를 추가합니다. sortDescriptions 는 ObservableArray 타입이라 변경 즉시 그리드가 자동으로 갱신됩니다.

Step 1: 정렬 버튼과 그리드 HTML 작성

정렬을 직접 제어할 버튼 두 개와 그리드 컨테이너를 배치합니다.

Step 2: CollectionView를 직접 만들어 그리드에 연결

일반 배열 대신 wijmo.collections.CollectionView 를 명시적으로 생성하여 itemsSource 로 사용합니다. 이렇게 해야 sortDescriptions 를 직접 참조해 정렬을 제어할 수 있습니다.

Step 3: SortDescription으로 정렬 기준 추가하기

wijmo.collections.SortDescription 생성자의 첫 번째 인자는 정렬할 속성 이름(문자열), 두 번째 인자는 오름차순 여부( true = 오름차순, false = 내림차순)입니다.

Step 4: 정렬 초기화 함수 만들기

sortDescriptions.clear() 를 호출하면 모든 정렬 기준이 제거되고 원래 데이터 순서로 돌아갑니다.

아래 예제에서 버튼을 클릭해 정렬 적용/초기화를 직접 확인해보세요. 초기 로드 시 이미 국가 오름차순·매출 내림차순으로 정렬된 상태로 표시됩니다.

실행 결과
💡 SUMMARY
CollectionView.sortDescriptions 에 SortDescription 객체를 추가·제거하면 코드 어디서든 정렬을 즉시 적용할 수 있으며, 그리드는 자동으로 업데이트된다.

자바스크립트 그리드에 Excel 스타일 필터 추가하기 (FlexGridFilter)

wijmo.grid.filter.FlexGridFilter 는 CDN의 wijmo.grid.filter.min.js 모듈이 제공하는 클래스로, 생성자에 그리드 인스턴스를 넘기기만 하면 모든 열 헤더에 필터 아이콘이 자동으로 추가됩니다.

필터 다이얼로그는 두 가지 탭을 제공합니다.

  • 값 필터(Value): 해당 열의 고유 값 목록에서 체크박스로 선택
  • 조건 필터(Condition): "포함", "시작", "같음" 등 조건식으로 필터링
💡 SUMMARY
한글 문화권 적용: CDN에서 wijmo.culture.ko.min.js 를 로드하면 필터 다이얼로그의 버튼 문구("적용", "취소", "모두 선택" 등)와 날짜·숫자 형식이 한국어로 자동 표시됩니다.

Step 1: 필터 예제용 HTML 구조 작성

그리드 컨테이너를 준비합니다. wijmo.grid.filter.FlexGridFilter 는 JavaScript로만 추가되므로 HTML에는 별도 태그가 필요 없습니다.

Step 2: FlexGridFilter 한 줄로 전체 열 필터 활성화

new wijmo.grid.filter.FlexGridFilter(grid) 한 줄이 전부입니다. 그리드 인스턴스를 생성한 직후에 호출합니다.

Step 3: FilterType으로 열마다 필터 방식 지정

getColumnFilter(binding) 메서드로 특정 열의 필터 설정에 접근하고, wijmo.grid.filter.FilterType 열거형으로 필터 타입을 지정합니다.

FilterType 열거형 정리:

값 설명
FilterType.Both 값 필터 + 조건 필터 모두 표시 (기본값)
FilterType.Value 값 체크박스 목록만 표시
FilterType.Condition 조건식 입력만 표시
FilterType.None 해당 열 필터 비활성화

아래 예제에서 열 헤더의 깔때기 아이콘을 클릭해 필터를 적용해보세요. 필터 다이얼로그 텍스트가 한국어로 표시됩니다.

실행 결과
💡 SUMMARY
new wijmo.grid.filter.FlexGridFilter(grid) 한 줄로 모든 열에 Excel 스타일 필터가 활성화되며, getColumnFilter() 와 FilterType 열거형으로 열별 필터 타입을 세밀하게 제어할 수 있다.

원하는 열만 정렬·필터 끄는 방법

ID 열이나 내부 코드 열처럼 정렬·필터가 의미 없는 열은 열 수준에서 비활성화하는 것이 UX에 유리합니다.

정렬 비활성화 — 컬럼 정의에서:

필터 비활성화 — FlexGridFilter 생성 후:

filterColumns 배열을 지정하면 목록에 포함된 열에만 필터 아이콘이 표시됩니다. 열 하나하나 FilterType.None 을 지정하는 것보다 간편합니다.

💡 SUMMARY
컬럼 정의의 allowSorting: false 로 정렬을, getColumnFilter().filterType = FilterType.None 또는 filter.filterColumns 배열로 필터를 열 단위로 제어한다.

정렬·필터 변경을 감지하는 이벤트 활용법

정렬·필터 변경 시점에 커스텀 로직(서버 재요청, 로그 기록, UI 업데이트 등)을 실행하려면 이벤트 핸들러를 등록합니다.

💡 SUMMARY
sortingColumn / sortedColumn 이벤트로 정렬 전후 커스텀 로직을 실행하고, FlexGridFilter.filterApplied 로 필터가 실제로 데이터에 적용된 시점을 감지할 수 있다.

자주 묻는 질문 (FAQ)

Q01

FlexGrid 정렬은 어떻게 켜고 끄나요?

allowSorting 속성을 wijmo.grid.AllowSorting.SingleColumn (기본값) 또는 MultiColumn 으로 지정합니다. 기본값이 SingleColumn 이라 따로 설정하지 않아도 열 헤더를 클릭하면 정렬됩니다. 정렬 기능을 완전히 끄려면 AllowSorting.None 을 사용합니다.
Q02

그리드에서 여러 열을 동시에 정렬하려면 어떻게 하나요?

allowSorting 을 wijmo.grid.AllowSorting.MultiColumn 으로 지정합니다. 이후 열 헤더를 클릭할 때마다 그 열이 정렬 우선순위에 추가되고 헤더에 순서 번호가 표시됩니다. 코드로 지정하려면 CollectionView.sortDescriptions 에 wijmo.collections.SortDescription 객체를 원하는 순서대로 추가하면 됩니다.
Q03

Excel처럼 열 헤더에서 필터링하는 기능은 어떻게 추가하나요?

CDN에서 wijmo.grid.filter.min.js 를 불러온 뒤 wijmo.grid.filter.FlexGridFilter 인스턴스를 만듭니다. 생성자에 그리드 인스턴스를 넘기기만 하면 모든 열 헤더에 필터 아이콘이 자동으로 추가됩니다.
Q04

필터 다이얼로그를 한국어로 보여주려면 어떻게 하나요?

CDN에서 한글 문화권 파일을 불러오면 필터 다이얼로그의 버튼("적용", "취소" 등)과 날짜·숫자 형식이 자동으로 한국어로 표시됩니다.
Q05

특정 열에서만 정렬이나 필터를 쓰지 못하게 하려면 어떻게 하나요?

정렬은 컬럼 정의에 allowSorting: false 를 추가해 끕니다. 필터는 FlexGridFilter 를 만든 뒤 getColumnFilter('binding').filterType = wijmo.grid.filter.FilterType.None 으로 지정하거나, filter.filterColumns 배열에 필터가 필요한 열만 지정하는 방법이 있습니다.
Q06

정렬 기준을 코드에서 직접 지정하고 바꾸려면 어떻게 하나요?

grid.collectionView.sortDescriptions.clear() 로 기존 정렬을 초기화한 다음, sortDescriptions.push(new wijmo.collections.SortDescription(property, ascending)) 로 새 정렬 기준을 추가합니다. sortDescriptions 는 ObservableArray 이므로 값이 바뀌면 그리드가 바로 갱신되어 refresh() 를 따로 호출할 필요가 없습니다.

Wijmo FlexGrid의 정렬과 필터는 allowSorting 속성 하나, wijmo.grid.filter.FlexGridFilter 클래스 한 줄로 시작해 CollectionView.sortDescriptions , FilterType 열거형으로 세부 제어까지 단계적으로 넓혀 갈 수 있습니다. 한글 문화권( wijmo.culture.ko.min.js )을 적용하면 필터 다이얼로그도 한국어로 표시되어 국내 사용자에게 자연스러운 화면을 제공합니다. 다음 글에서는 FlexGrid의 그룹핑과 집계(Aggregation) 기능을 다룹니다.

MESCIUS Wijmo

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

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

Wijmo 무료 체험판 다운로드