에러 백과

폼 필드에서 지원하지 않는 바인딩

템플릿에서 [formField] 디렉티브를 사용하는 엘리먼트에 시그널 폼이 이미 관리하는 프로퍼티를 바인딩하거나 정적 속성으로 설정했습니다. min, max, required, disabled, readonly 같은 프로퍼티의 값은 필드 상태에서만 결정합니다. 템플릿에서 이 프로퍼티를 지정하면 필드의 스키마 로직과 충돌합니다.

오류 메시지에는 문제의 바인딩이 표시됩니다. 예를 들어 "[min]에 바인딩할 수 없습니다" 또는 "required 속성을 설정할 수 없습니다"라는 메시지가 나타납니다.

import {Component, signal} from '@angular/core';
import {form, FormField} from '@angular/forms/signals';

@Component({
  selector: 'app-root',
  imports: [FormField],
  template: `
    <!-- NG8022: [formField]와 함께 [min], [max]를 사용할 수 없습니다. -->
    <input type="number" [formField]="f.age" [min]="18" [max]="99" />

    <!-- NG8022: [formField]와 함께 required 속성을 사용할 수 없습니다. -->
    <input type="text" [formField]="f.name" required />
  `,
})
export class App {
  f = form(signal({age: 20, name: ''}));
}

템플릿에서 필드가 관리하는 입력에 바인딩하면 커스텀 폼 컨트롤에도 같은 규칙이 적용됩니다. 예를 들어 max 입력을 선언한 컨트롤에 [max]를 바인딩하는 경우입니다.

[formField]와 함께 사용할 수 없는 프로퍼티는 다음과 같습니다:

  • 값: value, checked (기반 모델 시그널이 직접 관리)
  • 유효성 검사 규칙: required, min, max, minLength, maxLength, pattern (기본 HTML 속성인 minlength, maxlength 포함)
  • 상호작용 상태: disabled, readonly, hidden
  • 필드 상태와 메타데이터: name, dirty, touched, invalid, errors, pending, disabledReasons (커스텀 컨트롤에서는 FormField가 이 상태를 자동으로 전달하므로 수동으로 바인딩하면 충돌합니다.)

기본 엘리먼트에는 몇 가지 예외가 있습니다:

  • min과 max는 date, time, month, week, datetime-local 타입의 <input>에서 사용할 수 있습니다. 이 타입의 한계값은 2026-01-01 같은 날짜 또는 시간 문자열이며, 숫자를 사용하는 min()과 max() 규칙으로는 표현할 수 없습니다.
  • type을 동적으로 바인딩할 때도 min과 max를 사용할 수 있습니다. 컴파일러가 입력의 타입을 알 수 없기 때문입니다.
  • <input type="radio">에서 value는 선택 항목을 식별하므로 사용할 수 있습니다. 어떤 라디오 버튼이 선택되는지는 필드 값이 결정합니다.

오류 디버깅

템플릿에서 바인딩을 제거하고 프로퍼티의 종류에 따라 다음과 같이 처리하세요:

  • 값(value, checked): [formField]는 엘리먼트를 기반 모델 시그널에 자동으로 바인딩하고 양방향으로 동기화합니다. 값을 초기화하거나 변경하려면 form()에 전달한 모델 시그널을 갱신하세요.
  • 유효성 검사 규칙(required, min, max, maxLength 등): 해당 유효성 검사 규칙을 사용해 form()의 스키마 함수에 선언하세요.
  • 상호작용 상태(disabled, readonly, hidden): 스키마 규칙인 disabled(), readonly(), hidden()을 사용하세요. 선택적으로 when 조건을 전달하면 다른 필드에 따라 규칙을 적용할 수 있습니다. 폼 로직을 참고하세요.
  • 필드 상태와 메타데이터(dirty, touched, errors 등): 대체할 코드는 필요하지 않습니다. [formField]가 필드 상태를 적용하며, f.age().dirty()처럼 필드에서 직접 읽을 수 있습니다.

위 예제를 수정하면 다음과 같습니다:

import {Component, signal} from '@angular/core';
import {disabled, form, FormField, max, maxLength, min, required} from '@angular/forms/signals';

@Component({
  selector: 'app-root',
  imports: [FormField],
  template: `
    <input type="number" [formField]="f.age" />
    <input type="text" [formField]="f.name" />
  `,
})
export class App {
  f = form(signal({age: 20, name: ''}), (p) => {
    min(p.age, 18);
    max(p.age, 99);
    required(p.name);
    maxLength(p.name, 20);
    disabled(p.name, {when: ({valueOf}) => valueOf(p.age) < 18});
  });
}