0Pricing
Angular Academy · 강의

사용자 지정 컨트롤의 유효성 검사

사용자 지정 컨트롤에서 유효성 검사기를 제공합니다.

사용자 지정 컨트롤의 유효성 검사은(는) 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 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. ControlValueAccessor 인터페이스
  2. 값 작성과 등록
  3. 비활성 및 터치 상태 처리
  4. 사용자 지정 컨트롤의 유효성 검사
← Angular Academy(으)로 돌아가기