사용자 지정 컨트롤의 유효성 검사
사용자 지정 컨트롤에서 유효성 검사기를 제공합니다.
사용자 지정 컨트롤의 유효성 검사은(는) CoddyKit의 무료 Angular Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Angular Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Angular Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
자체 유효성 검사 컨트롤
사용자 지정 컨트롤은 Validator interface를 구현하고 NG_VALIDATORS에 등록하여 자체 유효성 검사 로직을 포함할 수 있습니다. 따라서 이를 사용하는 쪽에서는 별도의 작업 없이 유효성 검사 결과를 얻을 수 있습니다.
Validator interface
Validator에는 ValidationErrors(오류 맵)를 반환하거나 유효한 경우 null을 반환하는 validate method가 필요합니다.
import { Validator, ValidationErrors, AbstractControl } from '@angular/forms';
export class RatingComponent implements Validator {
validate(control: AbstractControl): ValidationErrors | null {
return control.value > 0 ? null : { required: true };
}
}NG_VALIDATORS 등록하기
NG_VALUE_ACCESSOR와 함께 NG_VALIDATORS를 위한 두 번째 다중 provider를 추가하고, 이번에도 forwardRef를 사용합니다.
import { NG_VALIDATORS } from '@angular/forms';
providers: [
{ provide: NG_VALUE_ACCESSOR, useExisting: forwardRef(() => RatingComponent), multi: true },
{ provide: NG_VALIDATORS, useExisting: forwardRef(() => RatingComponent), multi: true }
]오류 맵 반환하기
오류 맵의 키는 control.errors의 항목이 됩니다. 설명이 분명한 키와 선택적 페이로드를 사용하면 템플릿에서 상황에 맞는 메시지를 표시할 수 있습니다.
validate(control: AbstractControl): ValidationErrors | null {
const v = control.value;
if (v == null) return { required: true };
if (v < this.min) return { min: { required: this.min, actual: v } };
return null;
}오류 사용하기
템플릿에서는 기본 제공 유효성 검사기와 마찬가지로 control.errors를 읽어 컨트롤이 유효하지 않고 터치된 경우 메시지를 표시합니다.
<small *ngIf="form.controls.stars.errors?.['required']">Pick a rating</small>외부 유효성 검사기와 결합하기
컨트롤의 유효성 검사기와 사용하는 쪽에서 전달한 유효성 검사기(반응형 폼)가 모두 실행되고 병합됩니다. 컨트롤의 규칙은 폼의 규칙을 대체하지 않고 추가합니다.
stars: [0, [Validators.required]] // plus the control's own validate()동적 유효성 검사
유효성 검사가 변경되는 input에 따라 달라진다면, 등록된 변경 콜백을 호출하여 Angular에 유효성 검사를 다시 실행하라고 알립니다.
private onValidatorChange: () => void = () => {};
registerOnValidatorChange(fn: () => void) { this.onValidatorChange = fn; }
@Input() set min(v: number) { this._min = v; this.onValidatorChange(); }비동기 유효성 검사
서버 확인을 위해서는 오류의 Observable 또는 Promise를 반환하는 validate를 포함한 AsyncValidator를 구현하고 NG_ASYNC_VALIDATORS에 등록합니다.
validate(control: AbstractControl): Observable<ValidationErrors | null> {
return this.api.isUnique(control.value).pipe(
map(ok => ok ? null : { taken: true })
);
}범위를 명확히 유지하기
컨트롤 자체에 본질적인 유효성 검사만 컨트롤 내부에 넣습니다(예: 평점은 0보다 커야 함). 재사용성을 위해 업무별 규칙은 이를 사용하는 폼에 맡깁니다.
유효성 검사 테스트하기
값이 있는 가짜 컨트롤을 전달하고 반환된 오류 맵 또는 null을 확인하여 validate를 직접 단위 테스트합니다.
it('requires a rating', () => {
const c = new FormControl(0);
expect(component.validate(c)).toEqual({ required: true });
});완전한 사용자 지정 컨트롤
값 접근자, 비활성화, 터치됨 상태, 유효성 검사를 모두 구현하면 컴포넌트가 완전하고 재사용 가능한 폼 컨트롤이 됩니다. 이를 사용하는 쪽에서는 네이티브 input과 구별할 수 없습니다.
빠른 확인
유효성 검사에 대한 지식을 확인해 보세요.
복습
Validator.validate를 구현하고 NG_VALIDATORS를 등록하여 유효성 검사를 추가했습니다. 오류 맵을 반환하고 registerOnValidatorChange를 통해 동적 재검사를 지원했으며, 완전히 통합된 사용자 지정 컨트롤을 위해 선택적으로 NG_ASYNC_VALIDATORS와 함께 AsyncValidator도 사용할 수 있습니다.
자주 묻는 질문
“사용자 지정 컨트롤의 유효성 검사” 강의는 무료인가요?
네 — “사용자 지정 컨트롤의 유효성 검사” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Angular Academy 강의 전체를 잠금 해제할 수 있습니다. Angular Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“사용자 지정 컨트롤의 유효성 검사”에서 뭘 배우나요?
사용자 지정 컨트롤에서 유효성 검사기를 제공합니다. 브라우저에서 직접 실행하는 실습 코드로 Angular Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Angular Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Angular Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“사용자 지정 컨트롤의 유효성 검사” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Angular Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Angular Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- ControlValueAccessor 인터페이스
- 값 작성과 등록
- 비활성 및 터치 상태 처리
- 사용자 지정 컨트롤의 유효성 검사