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

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

Pe scurt

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.

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

Ce înseamnă

formControlName="nume" nu conține controlul, ci doar numele lui. Directiva urcă în arborele de elemente și caută cel mai apropiat [formGroup] (sau formGroupName / formArrayName) ca să ia de acolo controlul nume. Dacă nu găsește niciun grup părinte, aruncă NG01050 și îți dă și un exemplu de folosire corectă.

Cauzele obișnuite: ai uitat [formGroup]="form" pe <form>, ai scris formGroup="form" fără paranteze pătrate (atunci e un simplu atribut text), câmpul a ajuns în afara elementului cu [formGroup] după o mutare în șablon, sau câmpul e într-o componentă copil care nu vede grupul părintelui.

Mesajul afișează și numele controlului (Affected Form Control name: "nume"), ca să găsești câmpul. În versiunile recente textul spune „parent formGroup or formArray directive”.

De ce apare: cauzele frecvente

1Lipsește [formGroup] pe formular

Greșit
TypeScript
<form>
  <input formControlName="nume" />
</form>
Corect
TypeScript
<form [formGroup]="form">
  <input formControlName="nume" />
</form>

Grupul părinte îi dă lui formControlName locul din care să ia controlul.

2formGroup fără paranteze pătrate

Greșit
TypeScript
<form formGroup="form">
Corect
TypeScript
<form [formGroup]="form">

Fără [ ], valoarea este textul „form”, nu obiectul din clasă, iar directiva nu se leagă corect.

3Câmp mutat în afara formularului

Greșit
TypeScript
<form [formGroup]="form">...</form>
<input formControlName="nota" />
Corect
TypeScript
<form [formGroup]="form">
  ...
  <input formControlName="nota" />
</form>

Controlul se caută doar printre părinții elementului. În afara <form>-ului nu mai există grupul.

Repară tu

Repară eroarea, direct în pagină

Formularul de contact are câmpurile legate cu formControlName, dar elementul <form> nu e legat de grupul form, iar aplicația se oprește cu NG01050. Repară formularul ca, după ce scrii „Maria” în #nume, p#salut să afișeze „Mulțumim, Maria!”.

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>
      <input id="nume" formControlName="nume" />
    </form>
    <p id="salut">Mulțumim, {{ form.value.nume }}!</p>
  `
})
export class App {
  form = new FormGroup({ nume: new FormControl('') });
}
Indiciu

formControlName caută controlul într-un grup de pe un element părinte.

Alte forme ale mesajului

  • NG01050: formControlName must be used with a parent formGroup or formArray directive. You'll want to add a formGroup/formArray directive and pass it an existing FormGroup/FormArray instance (you can create one in your class). Affected Form Control name: "nume"
  • Error: formControlName must be used with a parent formGroup directive.

Cum o eviți pe viitor

  • Scrie întâi <form [formGroup]="form">, apoi câmpurile din interior.
  • Pentru câmpuri independente (căutare, filtru), folosește [formControl]="control", care nu cere grup.
  • Când muți câmpuri în componente copil, transmite-le controlul ([formControl]) sau grupul.
  • Folosește mereu paranteze pătrate: [formGroup]="form", nu formGroup="form".

Întrebări frecvente

Cum folosesc formControlName într-o componentă copil?

Copilul nu vede automat [formGroup] al părintelui. Transmite-i controlul ca input și folosește [formControl] în copil, sau injectează ControlContainer (soluție mai avansată).

Ce diferență e între formControl și formControlName?

[formControl] primește chiar obiectul FormControl. formControlName primește un nume și ia controlul din grupul părinte.

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.