SYIDAX / DATA GRID

데이터 검증

열별 규칙으로 값의 범위와 필수 입력을 검증합니다.

데이터 검증샘플 주문 데이터

120 rows

Grid를 불러오는 중입니다…

옵션

아래 항목을 바꾸면 Grid와 코드에 바로 반영됩니다.

유효하지 않은 편집

셀 편집

최근 결과

수량 셀을 편집해 -1을 입력하고 적용해 보세요. 이 예제의 수량은 0 이상이어야 합니다.

코드 보기

현재 미리보기

수량에 음수를 입력하는 것처럼 업무에서 허용하지 않는 값을 막을 때 사용합니다. 입력 형식과 업무 규칙을 함께 확인할 수 있습니다.

허용되지 않는 값 입력
수량 셀을 편집해 -1을 입력하고 적용해 보세요. 이 예제의 수량은 0 이상이어야 합니다.
기존 값 유지 확인
허용되지 않은 값이 유효한 주문 수량으로 남지 않는지 확인하세요. 편집기의 숫자 제한이나 검증 규칙이 적용을 막습니다.
정상 값으로 수정
같은 셀에 25를 입력하고 Enter를 누르세요. 수량과 합계가 정상적으로 바뀌는지 확인합니다.

확인할 결과

정상 입력은 반영되고 조건을 벗어난 입력은 차단됩니다. 검증 이벤트가 발생하면 실행 결과에서 이유를 읽을 수 있습니다.

브라우저의 검증만으로 서버 데이터가 보호되지는 않습니다. 저장 API에서도 같은 업무 규칙을 검사해야 합니다.

나머지 속성2

Attribute / Property	타입 / 기본값	설명
validationRules	`ValidationRule[]`기본값 undefined	Data validation. A grid-level list of per-column rules (required / number / integer / min / max / range / minLength / maxLength / pattern / oneOf / custom). A failing cell is MARKED invalid (a red state + the message as its title) — the edit is NOT blocked (the value lands, the cell flags it, spreadsheet-style by default). `invalid-edit-mode` can instead keep the editor open (`block`) or cancel/revert it (`revert`). A rejected or allowed-invalid edit fires `cellValidationFailed`. Blank passes every rule but `required`. Off by default (zero overhead).
invalidEditMode	`'allow' \| 'revert' \| 'block'`기본값 'allow'	Policy for an editor value that fails `validationRules`. `allow` preserves the existing spreadsheet-style mark-and-commit behavior.

이벤트1

이벤트	detail 타입	설명
	`{ rowIndex: number; field: string; value: unknown; message: string }`	Fires when a committed edit fails a validation rule.

메서드1

메서드 / 인수	반환 타입	설명
	`Promise< Array<{ rowIndex: number; rowId: unknown; field: string; value: unknown; message: string }> >`	every cell that currently fails a validation rule, in display order. Empty when there are no rules (zero overhead). A host uses this for an error summary / "jump to next error" / a save-guard.