NG0303: Can't bind to 'formControl' since it isn't a known property of 'input'.
Legi un câmp cu [formControl]="..." fără să fi importat ReactiveFormsModule în componentă. Adaugă ReactiveFormsModule în imports: [...], iar câmpul se va lega de FormControl-ul din clasă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
[formControl] leagă un singur câmp de un FormControl creat în clasă, fără un FormGroup în jur. Este des folosit pentru câmpuri de căutare sau filtre, unde ascultă valueChanges. Directiva vine din ReactiveFormsModule; fără el, Angular nu o cunoaște și raportează că formControl nu este o proprietate a lui <input>.
La build primești NG8002 și compilarea se oprește; în rulare JIT primești avertismentul NG0303, iar câmpul nu e legat: valueChanges nu emite nimic și control.value rămâne valoarea inițială.
Atenție la confuzia dintre formControl și formControlName: primul primește chiar obiectul ([formControl]="cautare"), al doilea primește numele unui control dintr-un grup (formControlName="cautare") și are nevoie de un [formGroup] părinte.
De ce apare: cauzele frecvente
1Lipsește importul modulului
@Component({
template: `<input [formControl]="cautare" />`
})
export class App { cautare = new FormControl(''); }@Component({
imports: [ReactiveFormsModule],
template: `<input [formControl]="cautare" />`
})
export class App { cautare = new FormControl(''); }Modulul aduce directiva care leagă câmpul de obiectul FormControl.
2Ai scris formControlName în loc de formControl
<input [formControlName]="cautare" /><input [formControl]="cautare" />formControlName cere un grup părinte și un nume; pentru un control independent folosești [formControl].
Repară eroarea, direct în pagină
Câmpul de căutare #cautare folosește [formControl], dar componenta nu importă modulul necesar și consola arată „Can't bind to 'formControl'”. Repară importul ca, după ce scrii „Dune”, p#termen să afișeze „Cauți: Dune”.
import { Component } from '@angular/core';
import { FormControl } from '@angular/forms';
@Component({
selector: 'app-root',
template: `
<input id="cautare" [formControl]="cautare" placeholder="Caută o carte" />
<p id="termen">Cauți: {{ cautare.value }}</p>
`
})
export class App {
cautare = new FormControl('');
}Indiciu
Directiva [formControl] face parte din formularele reactive.
Reparația
import { Component } from '@angular/core';
import { FormControl, ReactiveFormsModule } from '@angular/forms';
@Component({
selector: 'app-root',
imports: [ReactiveFormsModule],
template: `
<input id="cautare" [formControl]="cautare" placeholder="Caută o carte" />
<p id="termen">Cauți: {{ cautare.value }}</p>
`
})
export class App {
cautare = new FormControl('');
}De ce merge
Fără ReactiveFormsModule, Angular nu știa ce este [formControl] și a ignorat binding-ul (avertisment NG0303). Câmpul din pagină nu era legat de obiectul cautare, deci cautare.value rămânea gol.
Cu modulul importat, directiva conectează input-ul la FormControl: fiecare tastă actualizează valoarea controlului, iar paragraful afișează termenul căutat.
Alte forme ale mesajului
error NG8002: Can't bind to 'formControl' since it isn't a known property of 'input'.Can't bind to 'formControl' since it isn't a known property of 'select'.
Cum o eviți pe viitor
- Orice componentă care folosește
[formControl],[formGroup]sauformControlNameare nevoie deReactiveFormsModuleînimports. - Pentru câmpuri independente (căutare, filtre) folosește
[formControl]; pentru câmpuri din formulare,formControlNameîn[formGroup]. - Lasă editorul (Angular Language Service) să-ți arate directivele necunoscute încă din șablon.
Întrebări frecvente
De ce valueChanges nu emite nimic?
Fără directiva din ReactiveFormsModule, câmpul din pagină nu e conectat la FormControl. Controlul există în clasă, dar nimeni nu-i transmite ce scrii.
Pot folosi un FormControl fără formular?
Da. [formControl] e gândit exact pentru asta: un câmp singur, cu validare și valueChanges, fără FormGroup.
Erori înrudite
NG0303: Can't bind to 'formGroup' since it isn't a known property of 'form'. Folosești [formGroup] fără ReactiveFormsModule importat în componentă, așa că Angular nu cunoaște directiva. Adaugă ReactiveFormsModule în imports: [...] din @Component (FormsModule nu ajunge). Cannot find control with unspecified name attribute Directiva [formControl] a primit undefined: proprietatea din clasă are alt nume, nu e inițializată sau e un control scris greșit. Verifică că [formControl]="x" indică un FormControl existent, creat la declararea câmpului. NG0303: Can't bind to 'ngModel' since it isn't a known property of 'input'. Folosești [(ngModel)] fără să fi importat FormsModule în componentă, așa că Angular nu cunoaște directiva ngModel. Adaugă FormsModule în imports: [...] din @Component (sau în NgModule, la proiectele vechi). Învață Angular de la zero, cu exerciții la fiecare lecție
Curs Angular: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
