Wijmo FlexGrid 정렬·필터 구현: 다중 정렬부터 Excel 필터까지
Wijmo FlexGrid는 allowSorting
속성 하나로 단일·다중 열 정렬을 활성화하고, wijmo.grid.filter.FlexGridFilter
클래스 한 줄로 모든 열에 Excel과 동일한 필터 UI를 추가할 수 있습니다. 직접 DOM을 조작하거나 별도의 상태 관리 코드 없이도, 10만 행 이상의 대용량 데이터에서도 즉각적인 정렬·필터링 성능을 제공합니다. 이 글에서는 CDN 기반 순수 JavaScript 환경을 기준으로 기본 정렬부터 다중 열 동시 정렬, 프로그래매틱 정렬 제어, Excel 스타일 필터까지 단계별로 완벽하게 다룹니다.
wijmo.grid.filter.FlexGridFilter
처럼 전역 wijmo
객체를 사용합니다. npm/모듈 환경에서는 import { FlexGridFilter } from '@mescius/wijmo.grid.filter'
로 대체하세요.
allowSorting
속성의 세 가지 값( AllowSorting.None
, SingleColumn
, MultiColumn
)만 바꿔도 그리드의 정렬 동작을 원하는 대로 지정할 수 있다AllowSorting.MultiColumn
만 설정하면 여러 열을 동시에 정렬할 수 있고, 헤더에 정렬 순서 번호가 자동으로 표시된다CollectionView.sortDescriptions
에 SortDescription
객체를 추가하면 버튼 클릭 등 코드에서 원하는 시점에 정렬을 적용할 수 있다wijmo.grid.filter.FlexGridFilter
인스턴스를 하나 만들면 모든 열에 Excel 스타일 필터 아이콘이 붙는다getColumnFilter()
와 FilterType
을 쓰면 특정 열의 정렬·필터만 끄는 식으로 열별 동작을 세밀하게 조절할 수 있다wijmo.culture.ko.min.js
를 불러오면 필터 다이얼로그를 포함한 UI 텍스트가 한국어로 표시된다자바스크립트 그리드에 열 정렬 기능 추가하기
FlexGrid에서 정렬을 활성화하는 방법은 allowSorting
속성을 지정하는 것입니다. 기본값은 AllowSorting.SingleColumn
으로, 별도 설정 없이 열 헤더 클릭만으로 정렬이 동작합니다.
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
로 정렬이 비활성화됩니다.
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
클래스를 재정의하면 이 번호의 스타일을 바꿀 수 있습니다.
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()
를 호출하면 모든 정렬 기준이 제거되고 원래 데이터 순서로 돌아갑니다.
아래 예제에서 버튼을 클릭해 정렬 적용/초기화를 직접 확인해보세요. 초기 로드 시 이미 국가 오름차순·매출 내림차순으로 정렬된 상태로 표시됩니다.
CollectionView.sortDescriptions
에 SortDescription
객체를 추가·제거하면 코드 어디서든 정렬을 즉시 적용할 수 있으며, 그리드는 자동으로 업데이트된다.자바스크립트 그리드에 Excel 스타일 필터 추가하기 (FlexGridFilter)
wijmo.grid.filter.FlexGridFilter
는 CDN의 wijmo.grid.filter.min.js
모듈이 제공하는 클래스로, 생성자에 그리드 인스턴스를 넘기기만 하면 모든 열 헤더에 필터 아이콘이 자동으로 추가됩니다.
필터 다이얼로그는 두 가지 탭을 제공합니다.
- 값 필터(Value): 해당 열의 고유 값 목록에서 체크박스로 선택
- 조건 필터(Condition): "포함", "시작", "같음" 등 조건식으로 필터링
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 열거형 정리:
아래 예제에서 열 헤더의 깔때기 아이콘을 클릭해 필터를 적용해보세요. 필터 다이얼로그 텍스트가 한국어로 표시됩니다.
new wijmo.grid.filter.FlexGridFilter(grid)
한 줄로 모든 열에 Excel 스타일 필터가 활성화되며, getColumnFilter()
와 FilterType
열거형으로 열별 필터 타입을 세밀하게 제어할 수 있다.원하는 열만 정렬·필터 끄는 방법
ID 열이나 내부 코드 열처럼 정렬·필터가 의미 없는 열은 열 수준에서 비활성화하는 것이 UX에 유리합니다.
정렬 비활성화 — 컬럼 정의에서:
필터 비활성화 — FlexGridFilter 생성 후:
filterColumns
배열을 지정하면 목록에 포함된 열에만 필터 아이콘이 표시됩니다. 열 하나하나 FilterType.None
을 지정하는 것보다 간편합니다.
allowSorting: false
로 정렬을, getColumnFilter().filterType = FilterType.None
또는 filter.filterColumns
배열로 필터를 열 단위로 제어한다.정렬·필터 변경을 감지하는 이벤트 활용법
정렬·필터 변경 시점에 커스텀 로직(서버 재요청, 로그 기록, UI 업데이트 등)을 실행하려면 이벤트 핸들러를 등록합니다.
sortingColumn
/ sortedColumn
이벤트로 정렬 전후 커스텀 로직을 실행하고, FlexGridFilter.filterApplied
로 필터가 실제로 데이터에 적용된 시점을 감지할 수 있다.자주 묻는 질문 (FAQ)
FlexGrid 정렬은 어떻게 켜고 끄나요?
allowSorting
속성을 wijmo.grid.AllowSorting.SingleColumn
(기본값) 또는 MultiColumn
으로 지정합니다. 기본값이 SingleColumn
이라 따로 설정하지 않아도 열 헤더를 클릭하면 정렬됩니다. 정렬 기능을 완전히 끄려면 AllowSorting.None
을 사용합니다.
그리드에서 여러 열을 동시에 정렬하려면 어떻게 하나요?
allowSorting
을 wijmo.grid.AllowSorting.MultiColumn
으로 지정합니다. 이후 열 헤더를 클릭할 때마다 그 열이 정렬 우선순위에 추가되고 헤더에 순서 번호가 표시됩니다. 코드로 지정하려면 CollectionView.sortDescriptions
에 wijmo.collections.SortDescription
객체를 원하는 순서대로 추가하면 됩니다.
Excel처럼 열 헤더에서 필터링하는 기능은 어떻게 추가하나요?
wijmo.grid.filter.min.js
를 불러온 뒤 wijmo.grid.filter.FlexGridFilter
인스턴스를 만듭니다. 생성자에 그리드 인스턴스를 넘기기만 하면 모든 열 헤더에 필터 아이콘이 자동으로 추가됩니다.
필터 다이얼로그를 한국어로 보여주려면 어떻게 하나요?
특정 열에서만 정렬이나 필터를 쓰지 못하게 하려면 어떻게 하나요?
allowSorting: false
를 추가해 끕니다. 필터는 FlexGridFilter
를 만든 뒤 getColumnFilter('binding').filterType = wijmo.grid.filter.FilterType.None
으로 지정하거나, filter.filterColumns
배열에 필터가 필요한 열만 지정하는 방법이 있습니다.
정렬 기준을 코드에서 직접 지정하고 바꾸려면 어떻게 하나요?
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) 기능을 다룹니다.
