RealGrid 정렬 기능 사용하기
본 가이드에서는 한 개 이상의 컬럼을 옵션에서 정한 우선순위 순서로 컬럼 테이터를 정렬하는 방법에 대해 설명합니다.
RealGrid는 단일 컬럼에 대한 정렬뿐 아니라 한 개 이상의 컬럼에 대해서도 정렬할 수 있습니다. 컬럼 정렬은 sortingOptions.enabled 속성과 sortingOptions.style 속성에 의해 영향을 받습니다.
###컬럼 정렬 사용
그리드 sortingOptions.enabled 속성의 값이 true 이고 컬럼의 sortable이 true이면 사용자는 컬럼 해더을 클릭해 컬럼이 참조하는 필드 값들을 기준으로 데이터셋을 정렬시킬 수 있습니다.
또한 sortingOptions.style 설정에 따라 복수 필드에 대한 정렬 방식을 지정 할 수 있습니다.
정렬된 상태는 컬럼 해더에 “▼”, ”▲” 아이콘으로 SortDirection.ASCENDING과 SortDirection.DECENDING을 구분합니다.
sortingOptions 속성
속성 명 | 설명 |
---|---|
enables | 기본 값은 true 입니다. 사용자가 컬럼 해더를 클릭해서 컬럼을 정렬 시킬 수 있도록 할 것인지를 지정합니다. GridView.orderBy()는 이 속성 값과 상관없이 실행 합니다. |
style | 기본 값은 SortStyle.EXCLUSIVE 입니다. 그리드의 복수 컬럼에 대해 정렬 하는 방식을 지정합니다. |
SortStyle Type
속성 값 | 설명 |
---|---|
NONE | 정렬하지 않습니다. |
EXCLUSIVE | 마지막으로 클릭한 컬럼으로 정렬합니다. |
INCUSIVE | 처음으로 클릭한 컬럼을 우선으로 순서대로 정렬합니다. |
REVERS | 마지막으로 클릭한 컬럼을 우선으로 순서대로 정렬합니다. |
SortDirection Type
속성 값 | 설명 |
---|---|
ASCENDING | 순방향으로 정렬합니다. 컬럼 해더에 “▼” 아이콘으로 순방향 정렬 상태를 표시합니다. |
DECENDING | 역방향으로 정렬합니다. 컬럼 해더에 “▲” 아이콘으로 역방향 정렬 상태를 표시합니다. |
###예제
sortingOptions.style 값을 지정합니다.
var options = {}; options.style = "exclusive"; gridView.sortingOptions(options);
[EXCLUSIVE로 설정한 상태에서 컬럼 해더를 클릭해 정렬한 화면]
orderBy 함수를 사용해 정렬합니다.
var fields = ["field1", "field2"]; var dirs = [SortDirection.ASCENDING, SortDirection.DESCENDING]; grid.orderBy(fields, dirs);
정렬을 한 상태에서 그리드 데이터셋을 다시 로드해도 컬럼 해더의 정렬 상태 아이콘은 그대로 유지됩니다. 따라서 새로운 데이터셋을 로드하기 전에 정렬 상태를 초기화 하려면 grid.orderBy(null) 또는 grid.orderBy([]) 호출해야 합니다.
정렬은 컬럼이 참조하는 필드에서 텍스트, 숫자, 날짜및 시간을 기준으로 데이터를 정렬합니다. 필드에 데이터 타입이 정해져 있지 않으면 데이터를 텍스트로 변환해 정렬합니다.
###참고 항목 ColumnSorting Demo