...
Eroare Angular · Formulare template-driven și reactive

NG0303: Can't bind to 'formGroup' since it isn't a known property of 'form'.

Pe scurt

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

Greșit
TypeScript
@Component({
  imports: [],
  template: `<form [formGroup]="form">...</form>`
})
Corect
TypeScript
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

Greșit
TypeScript
imports: [FormsModule]
Corect
TypeScript
imports: [ReactiveFormsModule]

FormsModule conține doar directivele template-driven (ngModel, ngForm), nu pe cele reactive.

Repară tu

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”.

Codul care dă eroarea
TypeScript
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.

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

← Toate erorile Angular

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.