# cellValidationFailed

입력 검증이 실패했을 때 발생합니다. 대상 셀·입력값·메시지를 읽어 수정할 위치를 안내합니다.

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

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

## 무엇을 하는 API인가요

입력 검증이 실패했을 때 발생합니다. 대상 셀·입력값·메시지를 읽어 수정할 위치를 안내합니다.

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

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

```typescript
cellValidationFailed: { rowIndex: number; field: string; value: unknown; message: string }
```

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

## 사용 흐름

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

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

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

## 기능별 설명과 예제

- [데이터 검증](https://grid.syidax.com/ko/docs/features/validation-rules.md) — 선언형 규칙으로 필수값·숫자 범위·문자열 형식·사용자 규칙을 검사합니다. 기본 모드는 잘못된 값을 표시하는 방식일 수 있으므로 저장을 막아야 한다면 invalidEditMode를 명시합니다.