API REFERENCE

cellValidationFailed

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

무엇을 하는 API인가요

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

입력과 결과의 정확한 타입

typescript

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

사용 흐름

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

javascript

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

기능별 설명과 예제

데이터 검증
선언형 규칙으로 필수값·숫자 범위·문자열 형식·사용자 규칙을 검사합니다. 기본 모드는 잘못된 값을 표시하는 방식일 수 있으므로 저장을 막아야 한다면 invalidEditMode를 명시합니다.