# treeNodeToggled

트리 노드의 펼침 상태가 바뀌었을 때 발생합니다. 경로와 expanded를 확인합니다.

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

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

## 무엇을 하는 API인가요

트리 노드의 펼침 상태가 바뀌었을 때 발생합니다. 경로와 expanded를 확인합니다.

Pro 기능 관련 API: Tree data

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

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

```typescript
treeNodeToggled: { path: readonly string[]; expanded: boolean }
```

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

## 사용 흐름

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

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

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

## 기능별 설명과 예제

- [트리 데이터](https://grid.syidax.com/ko/docs/features/tree-data.md) — 트리는 폴더·조직도처럼 부모와 자식 관계가 있는 데이터를 들여쓰기와 펼침 버튼으로 보여 줍니다. 동일한 값끼리 묶는 행 그룹과 달리 부모 관계가 데이터에 이미 존재합니다.