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

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

Pe scurt

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

Greșit
TypeScript
<form [formGroup]="form">...</form>
<div formArrayName="produse">...</div>
Corect
TypeScript
<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]

Greșit
TypeScript
<form>
  <div formArrayName="produse">...</div>
</form>
Corect
TypeScript
<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ă tu

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

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

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

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