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".
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
formArrayName="produse" funcționează ca formControlName: primește doar un nume și caută FormArray-ul cu acel nume în grupul părinte. Fără un [formGroup] deasupra, nu are unde căuta și aruncă NG01054, cu un exemplu de structură corectă în mesaj.
Se întâmplă când lista dinamică (produse, adrese, telefoane) e mutată în afara <form>-ului, când e pusă într-o componentă copil separată sau când ai uitat [formGroup] pe formular.
Reparații: lista rămâne în interiorul elementului cu [formGroup]; dacă array-ul nu face parte dintr-un grup, îl legi direct cu [formArray]="telefoane" (disponibil în Angular 18+) sau legi fiecare control cu [formControl] dintr-un @for.
De ce apare: cauzele frecvente
1Lista în afara formularului
<form [formGroup]="form">...</form>
<div formArrayName="produse">...</div><form [formGroup]="form">
...
<div formArrayName="produse">...</div>
</form>Fiind în interiorul formularului, formArrayName găsește array-ul produse din grup.
2Formular fără [formGroup]
<form>
<div formArrayName="produse">...</div>
</form><form [formGroup]="form">
<div formArrayName="produse">...</div>
</form>Grupul părinte e cel care conține array-ul; fără el, numele nu are sens.
Repară eroarea, direct în pagină
Formularul de factură are lista de produse (formArrayName="produse") în afara elementului <form [formGroup]>, iar aplicația se oprește cu NG01054. Mută lista în interiorul formularului ca pagina să afișeze două câmpuri .produs, primul cu „Monitor”.
import { Component } from '@angular/core';
import { ReactiveFormsModule, FormGroup, FormControl, FormArray } from '@angular/forms';
@Component({
selector: 'app-root',
imports: [ReactiveFormsModule],
template: `
<form [formGroup]="form">
<input id="client" formControlName="client" />
</form>
<div formArrayName="produse">
@for (p of produse.controls; track $index) {
<input class="produs" [formControlName]="$index" />
}
</div>
`
})
export class App {
form = new FormGroup({
client: new FormControl('SC Alfa SRL'),
produse: new FormArray([new FormControl('Monitor'), new FormControl('Tastatură')])
});
get produse() { return this.form.controls.produse; }
}Indiciu
formArrayName caută array-ul într-un [formGroup] de deasupra lui.
Reparația
import { Component } from '@angular/core';
import { ReactiveFormsModule, FormGroup, FormControl, FormArray } from '@angular/forms';
@Component({
selector: 'app-root',
imports: [ReactiveFormsModule],
template: `
<form [formGroup]="form">
<input id="client" formControlName="client" />
<div formArrayName="produse">
@for (p of produse.controls; track $index) {
<input class="produs" [formControlName]="$index" />
}
</div>
</form>
`
})
export class App {
form = new FormGroup({
client: new FormControl('SC Alfa SRL'),
produse: new FormArray([new FormControl('Monitor'), new FormControl('Tastatură')])
});
get produse() { return this.form.controls.produse; }
}De ce merge
formArrayName="produse" caută array-ul după nume în cel mai apropiat [formGroup] părinte. Lista era în afara <form>-ului, deci nu avea niciun grup deasupra, iar Angular a aruncat NG01054.
Mutată în interiorul formularului, lista găsește array-ul produse din form. Fiecare [formControlName]="$index" se leagă de controlul de pe poziția lui, iar câmpurile afișează produsele.
Alte forme ale mesajului
Error: formArrayName must be used with a parent formGroup directive.
Cum o eviți pe viitor
- Păstrează toate directivele cu
...Name(formControlName,formGroupName,formArrayName) în interiorul unui[formGroup]. - Pentru un array independent, folosește
[formArray]sau[formControl]pe fiecare element. - Când împarți un formular în componente copil, transmite-le controlul sau array-ul ca input.
- Verifică indentarea șablonului după mutări: arată imediat ce element a ieșit din
<form>.
Întrebări frecvente
Pot folosi formArrayName într-o componentă copil?
Nu direct: copilul nu vede [formGroup] al părintelui. Transmite-i FormArray-ul ca input și leagă elementele cu [formControl] sau [formGroup] în copil.
Care e diferența dintre formArrayName și [formArray]?
formArrayName primește un nume și caută array-ul într-un grup părinte. [formArray] primește chiar obiectul FormArray, deci nu are nevoie de grup.
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. Cannot find control with path: 'adrese -> 0 -> strada' Într-un FormArray de grupuri, șablonul caută controlul strada în grupul de la poziția 0, dar grupurile din array nu au acest control. Construiește fiecare grup din array cu toate controalele folosite în șablon (de obicei printr-o funcție comună). NG01001: Cannot find form control at index: 1 Ai apelat setValue() pe un FormArray cu mai multe valori decât controale are array-ul. setValue nu adaugă controale noi: golește array-ul și adaugă câte un FormControl pentru fiecare valoare (clear() + push()). Î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.
