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.
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
<form>
<input formControlName="nume" />
</form><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
<form formGroup="form"><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
<form [formGroup]="form">...</form>
<input formControlName="nota" /><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ă 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!”.
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.
Reparația
import { Component } from '@angular/core';
import { ReactiveFormsModule, FormGroup, FormControl } from '@angular/forms';
@Component({
selector: 'app-root',
imports: [ReactiveFormsModule],
template: `
<form [formGroup]="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('') });
}De ce merge
formControlName="nume" căuta un [formGroup] printre elementele părinte ca să ia controlul nume. <form> nu era legat de niciun grup, așa că Angular a aruncat NG01050.
[formGroup]="form" leagă formularul de obiectul din clasă. Câmpul își găsește controlul, fiecare tastă actualizează form.value.nume, iar paragraful afișează mulțumirea.
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", nuformGroup="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
NG01052: formGroup expects a FormGroup instance. Please pass one in. [formGroup] a primit undefined sau null, de obicei pentru că grupul se creează abia după ce datele vin de la server sau în ngOnInit al altui obiect. Creează FormGroup-ul imediat (la declararea câmpului) și completează-l mai târziu cu patchValue. 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. 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". Î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.
