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).
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]
<form>
<div formGroupName="adresa">
<input formControlName="oras" />
</div>
</form><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
<!-- app-adresa -->
<div formGroupName="adresa">...</div><!-- 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ă 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”.
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.
Reparația
import { Component } from '@angular/core';
import { ReactiveFormsModule, FormGroup, FormControl } from '@angular/forms';
@Component({
selector: 'app-root',
imports: [ReactiveFormsModule],
template: `
<form [formGroup]="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('') })
});
}De ce merge
formGroupName="adresa" căuta subgrupul adresa într-un grup părinte, dar <form> nu era legat de niciun grup, așa că Angular a aruncat NG01053.
Cu [formGroup]="form", subgrupul își găsește obiectul, iar câmpul oras își găsește controlul în subgrup. Ce scrii ajunge în form.value.adresa.oras, iar paragraful afișează orașul.
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șiformArrayNameau 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", nuformGroup="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
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. NG01054: formArrayName 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 element are formArrayName, dar nu e în interiorul unui element cu [formGroup]. formArrayName ia array-ul după nume din grupul părinte: pune lista în <form [formGroup]="form"> sau, pentru un FormArray independent, folosește [formArray]="array". Cannot find control with name: 'email' Un câmp din șablon are formControlName="email", dar grupul din clasă nu are niciun control cu acest nume (lipsește sau e scris altfel). Adaugă controlul în FormGroup / fb.group sau corectează numele din șablon. Î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.
