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

NG01053: formGroupName 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).

Pe scurt

Un element are formGroupName (un subgrup, de exemplu adresa), dar deasupra lui nu există niciun [formGroup]. formGroupName ia subgrupul după nume din grupul părinte: pune [formGroup]="form" pe <form> sau mută subgrupul în interiorul lui.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Formularele reactive pot avea grupuri imbricate: form = new FormGroup({ adresa: new FormGroup({ oras, strada }) }). În șablon, subgrupul se leagă cu formGroupName="adresa", iar câmpurile din el cu formControlName="oras". formGroupName primește doar un nume și caută subgrupul în cel mai apropiat [formGroup] de deasupra. Dacă nu există, aruncă NG01053, cu un exemplu de structură corectă.

Cauze obișnuite: <form> fără [formGroup]="form", formGroup="form" scris fără paranteze pătrate, subgrupul mutat în afara formularului sau într-o componentă copil care nu vede grupul părintelui.

Este „fratele” erorilor NG01050 (formControlName) și NG01054 (formArrayName): toate directivele care se termină în Name au nevoie de un grup părinte. Dacă subgrupul trebuie să stea într-o componentă separată, transmite-i obiectul FormGroup și leagă-l acolo cu [formGroup].

De ce apare: cauzele frecvente

1Formular fără [formGroup]

Greșit
TypeScript
<form>
  <div formGroupName="adresa">
    <input formControlName="oras" />
  </div>
</form>
Corect
TypeScript
<form [formGroup]="form">
  <div formGroupName="adresa">
    <input formControlName="oras" />
  </div>
</form>

Grupul principal conține subgrupul adresa, iar formGroupName îl găsește acolo.

2Subgrup într-o componentă copil

Greșit
TypeScript
<!-- app-adresa -->
<div formGroupName="adresa">...</div>
Corect
TypeScript
<!-- părinte -->
<app-adresa [grup]="form.controls.adresa" />
<!-- app-adresa -->
<div [formGroup]="grup()">...</div>

Copilul primește chiar obiectul subgrupului și îl leagă cu [formGroup], fără să depindă de părinte.

Repară tu

Repară eroarea, direct în pagină

Formularul de livrare are subgrupul adresa legat cu formGroupName, dar <form> nu e legat de grupul form, iar aplicația se oprește cu NG01053. Repară formularul ca, după ce scrii „Timișoara” în #oras, p#livrare să afișeze „Livrăm în Timișoara”.

Codul care dă eroarea
TypeScript
import { Component } from '@angular/core';
import { ReactiveFormsModule, FormGroup, FormControl } from '@angular/forms';

@Component({
  selector: 'app-root',
  imports: [ReactiveFormsModule],
  template: `
    <form>
      <div formGroupName="adresa">
        <input id="oras" formControlName="oras" />
      </div>
    </form>
    <p id="livrare">Livrăm în {{ form.value.adresa?.oras }}</p>
  `
})
export class App {
  form = new FormGroup({
    adresa: new FormGroup({ oras: new FormControl('') })
  });
}
Indiciu

formGroupName caută subgrupul într-un [formGroup] de deasupra lui.

Alte forme ale mesajului

  • Error: formGroupName must be used with a parent formGroup directive.

Cum o eviți pe viitor

  • Pornește orice formular reactiv cu <form [formGroup]="form"> și pune totul în interior.
  • Ține minte regula: formControlName, formGroupName și formArrayName au nevoie de un grup părinte.
  • Pentru bucăți de formular reutilizabile, transmite subgrupul ca input și leagă-l cu [formGroup].
  • Verifică parantezele pătrate: [formGroup]="form", nu formGroup="form".

Întrebări frecvente

Ce diferență e între formGroupName și [formGroup]?

[formGroup] primește obiectul FormGroup și poate sta oriunde. formGroupName primește numele unui subgrup și îl caută într-un grup părinte.

Pot avea mai multe niveluri de subgrupuri?

Da: formGroupName="livrare" în interior cu formGroupName="adresa" și apoi câmpurile. Fiecare nivel caută numele în nivelul de deasupra.

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.