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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
[formGroup] este o directivă din ReactiveFormsModule. Fără importul ei, Angular vede un binding pe proprietatea formGroup a elementului <form>, care nu există, și afișează mesajul. La ng build este eroarea de compilare NG8002; în rulare JIT este avertismentul NG0303, iar formularul nu se leagă de grup: câmpurile cu formControlName rămân simple input-uri.
Cele mai frecvente cauze: ai importat FormsModule (care e pentru ngModel) în loc de ReactiveFormsModule, ai uitat importul într-o componentă nouă, sau, în proiectele cu NgModule, ai importat modulul în AppModule, dar componenta e declarată în alt modul.
Reparația: import { ReactiveFormsModule } from '@angular/forms'; și imports: [ReactiveFormsModule] în componenta care conține formularul.
De ce apare: cauzele frecvente
1Lipsește ReactiveFormsModule
@Component({
imports: [],
template: `<form [formGroup]="form">...</form>`
})import { ReactiveFormsModule } from '@angular/forms';
@Component({
imports: [ReactiveFormsModule],
template: `<form [formGroup]="form">...</form>`
})ReactiveFormsModule aduce directivele formGroup, formControlName, formArrayName și formControl.
2FormsModule importat în locul lui
imports: [FormsModule]imports: [ReactiveFormsModule]FormsModule conține doar directivele template-driven (ngModel, ngForm), nu pe cele reactive.
Repară eroarea, direct în pagină
Formularul de livrare folosește [formGroup] și formControlName, dar componenta nu importă modulul formularelor reactive, iar consola arată „Can't bind to 'formGroup'”. Repară importul ca, după ce scrii „Cluj” în #oras, p#livrare să afișeze „Livrare în Cluj”.
import { Component } from '@angular/core';
import { FormGroup, FormControl } from '@angular/forms';
@Component({
selector: 'app-root',
template: `
<form [formGroup]="form">
<input id="oras" formControlName="oras" />
</form>
<p id="livrare">Livrare în {{ form.value.oras }}</p>
`
})
export class App {
form = new FormGroup({ oras: new FormControl('') });
}Indiciu
Directivele formularelor reactive vin dintr-un modul din @angular/forms.
Reparația
import { Component } from '@angular/core';
import { ReactiveFormsModule, FormGroup, FormControl } from '@angular/forms';
@Component({
selector: 'app-root',
imports: [ReactiveFormsModule],
template: `
<form [formGroup]="form">
<input id="oras" formControlName="oras" />
</form>
<p id="livrare">Livrare în {{ form.value.oras }}</p>
`
})
export class App {
form = new FormGroup({ oras: new FormControl('') });
}De ce merge
Fără ReactiveFormsModule, [formGroup] era tratat ca o proprietate necunoscută a lui <form> (NG0303), iar formControlName era doar un atribut HTML. Textul scris nu ajungea în grup.
Cu modulul importat, directivele leagă formularul de form și câmpul de controlul oras. Fiecare tastă actualizează form.value.oras, iar paragraful afișează orașul.
Alte forme ale mesajului
error NG8002: Can't bind to 'formGroup' since it isn't a known property of 'form'.Can't bind to 'formGroup' since it isn't a known property of 'div'.
Cum o eviți pe viitor
- Pentru fiecare componentă cu
[formGroup], verificăimports: [ReactiveFormsModule]. - Ține minte perechea: reactive =
ReactiveFormsModule, template-driven =FormsModule. - La NgModule-uri, importul se face în modulul care declară componenta, nu doar în cel principal.
- Angular Language Service din editor subliniază directivele necunoscute încă înainte de build.
Întrebări frecvente
Am importat ReactiveFormsModule în app.config.ts. De ce nu merge?
Directivele nu se înregistrează prin providers. Fiecare componentă standalone trebuie să le aibă în propriul imports: [...].
Eroarea spune div, nu form. E aceeași?
Da, [formGroup] se poate pune pe orice element (de exemplu un <div>). Mesajul folosește numele elementului pe care l-ai pus.
Erori înrudite
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ă. NG01050: formControlName must be used with a parent formGroup directive. You'll want to add a formGroup directive and pass it an existing FormGroup instance (you can create one in your class). Un câmp are formControlName, dar niciun element părinte nu are [formGroup]. formControlName caută controlul după nume într-un grup, deci are nevoie de el: pune [formGroup]="form" pe <form> sau folosește [formControl] pentru un câmp independent. 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.
