# setSortModel

정렬 기준 목록과 우선순위를 한 번에 교체합니다. 빈 배열로 전체 정렬을 해제합니다.

Canonical: https://grid.syidax.com/ko/docs/methods/setSortModel/

<a id="meaning"></a>

## 무엇을 하는 API인가요

정렬 기준 목록과 우선순위를 한 번에 교체합니다. 빈 배열로 전체 정렬을 해제합니다.

<a id="contract"></a>

## 입력과 결과의 정확한 타입

```typescript
setSortModel(model: ReadonlyArray<{ field: string; direction: 'asc' | 'desc' }>): Promise<void>
```

| 인수 | 필수 여부 | 타입 |
| --- | --- | --- |
| model | 필수 | ReadonlyArray<{ field: string; direction: 'asc' \| 'desc' }> |

반환 타입은 `Promise<void>`입니다.

<a id="usage"></a>

## 사용 흐름

등록과 초기화를 마친 Grid 요소에서 grid.setSortModel(…)를 호출합니다. 반환값은 await로 읽으세요. boolean이나 보고서를 반환하는 메서드는 결과를 확인한 뒤 다음 작업을 진행합니다.

<a id="recipes"></a>

## 기능별 설명과 예제

- [단일·다중 정렬](https://grid.syidax.com/ko/docs/features/sorting.md) — 정렬은 데이터 값을 수정하지 않고 표시 순서를 바꿉니다. 단일 정렬은 한 기준만, 다중 정렬은 우선순위가 있는 여러 기준을 사용합니다.