데이터(Data)

다중 정렬

QCELL 에서는 여러 개의 컬럼을 동시에 정렬할 수 있도록 다중 정렬 API 를 제공합니다.
사용자는 UI에서 Shift 키를 이용한 정렬과 API를 통한 정렬 방식을 선택할 수 있으며, 정렬된 컬럼은 정렬 아이콘 옆에 순서 번호가 표시되어 쉽게 확인할 수 있습니다.


다중 정렬 기능을 활용하면:

✔ 여러 개의 컬럼을 지정하여 원하는 순서대로 데이터를 정렬할 수 있습니다.
✔ 정렬 아이콘을 다시 클릭하면 해당 컬럼의 정렬이 개별적으로 해제됩니다.
✔ UI 조작과 API를 병행하여 더욱 정밀한 데이터 정렬이 가능합니다.




1️⃣ UI를 통한 다중 정렬

Shift 키를 누른 상태에서 정렬이 설정된 컬럼의 정렬 아이콘을 클릭하면 다중 정렬이 적용됩니다.
다중 정렬이 적용되면, 정렬 아이콘 옆에 정렬 순서 번호(1, 2, 3, …)가 표시됩니다.
해당 순서 번호를 다시 클릭하면 다중 정렬이 해제됩니다.




2️⃣ API를 사용한 단일 컬럼 정렬

sort() API를 사용하면 특정 컬럼을 원하는 기준에 따라 단일 정렬할 수 있습니다.

qcell.sort([[5, 'asc', 'number']]);



3️⃣ API를 사용한 다중 컬럼 정렬

sort() API를 사용하면 다중 컬럼을 원하는 기준에 따라 정렬할 수 있습니다.
다중 정렬이 적용된 경우 정렬 순서가 자동으로 설정됩니다.

qcell.sort([[1, 'asc', 'string'], [2, 'desc', 'string']]);


📌 매개변수 설명 (더 쉽게 이해하기!)

파라미터 타입 설명
columnIndex number 정렬할 컬럼의 인덱스 값
sortOrder string ('asc' / 'desc') 오름차순(asc) 또는 내림차순(desc) 정렬
dataType string ('string' / 'number') 정렬할 데이터의 타입 (문자열 또는 숫자)