# rowGroupChanged

행 그룹 기준이 바뀌었을 때 발생합니다. 기준 필드와 그룹 해제 상태를 확인합니다.

Canonical: https://grid.syidax.com/ko/docs/events/rowGroupChanged/

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

## 무엇을 하는 API인가요

행 그룹 기준이 바뀌었을 때 발생합니다. 기준 필드와 그룹 해제 상태를 확인합니다.

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

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

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

```typescript
rowGroupChanged: { groupBy: string | null }
```

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

## 사용 흐름

grid.addEventListener('rowGroupChanged', handler)로 구독합니다. 실제 결과는 event.detail에 들어 있고 이름의 대소문자를 구분합니다. 화면을 닫을 때 구독을 해제하세요.

```javascript
const controller = new AbortController();
grid.addEventListener('rowGroupChanged', event => {
  console.log(event.detail);
}, { signal: controller.signal });
// 화면을 해제할 때 controller.abort();
```

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

## 기능별 설명과 예제

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