템플릿에서 [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});
});
}