# columnGroupToggled

열 그룹 머리글을 펼치거나 접었을 때 발생합니다. groupId와 open으로 현재 상태를 읽습니다.

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

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

## 무엇을 하는 API인가요

열 그룹 머리글을 펼치거나 접었을 때 발생합니다. groupId와 open으로 현재 상태를 읽습니다.

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

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

```typescript
columnGroupToggled: { groupId: string; open: boolean }
```

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

## 사용 흐름

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

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

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

## 기능별 설명과 예제

- [다단 헤더](https://grid.syidax.com/ko/docs/features/column-groups.md) — 다단 헤더는 관련 열을 하나의 상위 제목 아래 배치합니다. 행을 묶는 그룹화와 달리 데이터 개수나 집계값은 바뀌지 않습니다.