# cellValueChanged

셀의 실제 값이 바뀌었을 때 발생합니다. 행·필드·변경 전후 값으로 저장이나 활동 내역을 구성합니다.

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

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

## 무엇을 하는 API인가요

셀의 실제 값이 바뀌었을 때 발생합니다. 행·필드·변경 전후 값으로 저장이나 활동 내역을 구성합니다.

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

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

```typescript
cellValueChanged: GridCellValueChangedDetail
```

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

## 사용 흐름

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

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

<a id="types"></a>

## 관련 타입 읽기

- [GridCellValueChangedDetail](https://grid.syidax.com/ko/docs/types/GridCellValueChangedDetail.md)

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

## 기능별 설명과 예제

- [데이터 갱신](https://grid.syidax.com/ko/docs/features/data-updates.md) — 조회 결과 전체를 새로 받았다면 rowData를 교체합니다. 일부 주문만 바뀌었다면 applyTransaction에 add·update·remove를 전달합니다. 갱신은 화면 위치가 아니라 getRowId로 연결됩니다.