# groupBy

같은 값의 행을 그룹으로 묶습니다. 문자열 배열은 앞 항목부터 다단계 그룹을 만듭니다.

Canonical: https://grid.syidax.com/ko/docs/options/groupBy/

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

## 무엇을 하는 API인가요

같은 값의 행을 그룹으로 묶습니다. 문자열 배열은 앞 항목부터 다단계 그룹을 만듭니다.

Pro 기능 관련 API: Row grouping, built-in aggregation and group totals

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

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

```typescript
groupBy: string | string[]
```

| 항목 | 값 |
| --- | --- |
| JavaScript 이름 | groupBy |
| HTML 속성 | group-by |
| 기본값 | undefined |
| 입력 타입 | string \| string[] |

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

## 사용 흐름

이 항목은 Grid 요소의 프로퍼티에 설정합니다. 배열·객체·콜백 함수는 JavaScript로 전달하고, 변경을 반영할 때 새 배열이나 객체를 사용하세요.

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

## 기능별 설명과 예제

- [그룹과 집계](https://grid.syidax.com/ko/docs/features/row-grouping.md) — 행 그룹은 같은 지역이나 팀에 속한 원본 행을 접고 펼칠 수 있게 묶습니다. 열 그룹이 머리글을 묶는 것과 달리, 행 그룹은 표시 행과 집계 결과를 바꿉니다.