f.SheetControl().sort()

f.SheetControl(fid, sector).sort(keyOrFn, order)

개요

sort()를 통해 시트 컨트롤의 행을 정렬시킬 수 있습니다.

• 첫 번째 인자로 컬렉션 키(String)를 전달하면,

  해당 키의 값을 기준으로 지정한 정렬 방향(order)에 따라 정렬합니다.

• 첫 번째 인자로 함수를 전달하면,

  커스텀 정렬 로직(예: 2개 이상의 조건을 이용한 복합 정렬 등)에 따라 자유롭게 정렬할 수 있습니다.

이벤트 스크립트에서만 사용가능합니다.

대상 컨트롤 컴포넌트 : Sheet

파라미터

파라미터명	필수여부	타입	제약사항	설명
keyOrFn	Yes	String | Function		정렬할 기준 콜렉션 키 또는 비교 함수
order		Literal	'asc' | 'desc’ 만 가능	콜렉션키 사용시 정렬방향을 지정 인자 (기본값 : “asc”)

예시

// 단일 키 기준 오름차순 정렬
f.SheetControl('f_10476').sort('qty', 'asc');
f.SheetControl('f_10476', _c.testCategory.activeSector).sort('qty', 'asc');


// 1. ItemName(오름차순), qty(내림차순) 복합 정렬
f.SheetControl('f_10476').sort((a, b) => {
  // 1순위: ItemName 알파벳 오름차순
  const nameCompare = a.ItemName.localeCompare(b.ItemName);
  if (nameCompare !== 0) return nameCompare;

  // 2순위: qty(수량) 내림차순
  return b.qty - a.qty;
});