NG01352: If ngModel is used within a form tag, either the name attribute must be set or the form control must be defined as 'standalone' in ngModelOptions.
Un câmp cu [(ngModel)] stă în interiorul unui <form>, dar nu are atributul name. În formularele template-driven, name este cheia sub care câmpul se înregistrează în formular. Adaugă name="..." (sau [ngModelOptions]="{ standalone: true }" dacă nu vrei să facă parte din formular).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când FormsModule este importat, orice <form> devine automat un NgForm: un grup care ține evidența tuturor câmpurilor lui (valoare, validitate, touched). Fiecare ngModel din interior se înregistrează în acest grup sub numele din atributul name. Fără name, Angular nu are cheia sub care să-l pună, așa că aruncă NG01352.
Mesajul complet include și două exemple: <input [(ngModel)]="person.firstName" name="first"> și varianta cu [ngModelOptions]="{standalone: true}". Prima este aproape mereu cea corectă: numele devine cheia din f.value ({ first: '...' }) și permite validarea întregului formular.
standalone: true e util doar pentru câmpuri care nu trebuie să facă parte din datele formularului, de exemplu un filtru sau o bifă „arată parola”.
De ce apare: cauzele frecvente
1Câmp fără name în formular
<form #f="ngForm">
<input [(ngModel)]="client.email" />
</form><form #f="ngForm">
<input name="email" [(ngModel)]="client.email" />
</form>Cu name="email", câmpul se înregistrează în formular, iar f.value.email și f.valid îl iau în calcul.
2Câmp ajutător care nu ține de datele formularului
<form #f="ngForm">
<input type="checkbox" [(ngModel)]="aratParola" />
</form><form #f="ngForm">
<input type="checkbox" [(ngModel)]="aratParola"
[ngModelOptions]="{ standalone: true }" />
</form>standalone: true spune că acest câmp nu se înregistrează în formular, deci nu are nevoie de name.
Repară eroarea, direct în pagină
Formularul de abonare are un câmp #email cu [(ngModel)] fără name, iar aplicația se oprește cu NG01352. Repară câmpul ca, după ce scrii „ana@exemplu.ro” și trimiți formularul, p#confirmare să afișeze „Abonat: ana@exemplu.ro”.
import { Component, signal } from '@angular/core';
import { FormsModule } from '@angular/forms';
@Component({
selector: 'app-root',
imports: [FormsModule],
template: `
<form (ngSubmit)="trimite()">
<input id="email" [(ngModel)]="email" />
<button type="submit">Abonează-mă</button>
</form>
<p id="confirmare">{{ confirmare() }}</p>
`
})
export class App {
email = '';
confirmare = signal('');
trimite() { this.confirmare.set('Abonat: ' + this.email); }
}Indiciu
În interiorul unui <form>, fiecare ngModel are nevoie de un atribut.
Reparația
import { Component, signal } from '@angular/core';
import { FormsModule } from '@angular/forms';
@Component({
selector: 'app-root',
imports: [FormsModule],
template: `
<form (ngSubmit)="trimite()">
<input id="email" name="email" [(ngModel)]="email" />
<button type="submit">Abonează-mă</button>
</form>
<p id="confirmare">{{ confirmare() }}</p>
`
})
export class App {
email = '';
confirmare = signal('');
trimite() { this.confirmare.set('Abonat: ' + this.email); }
}De ce merge
Fiind într-un <form>, câmpul cu ngModel încerca să se înregistreze în NgForm-ul formularului. Fără name, nu avea o cheie sub care să fie pus, iar Angular a aruncat NG01352.
Cu name="email", câmpul devine parte din formular (f.value.email), legătura [(ngModel)] funcționează, iar la trimitere mesajul de confirmare afișează adresa scrisă.
Alte forme ale mesajului
Error: NG01352: If ngModel is used within a form tag, either the name attribute must be set or the form control must be defined as 'standalone' in ngModelOptions. Example 1: <input [(ngModel)]="person.firstName" name="first">
Cum o eviți pe viitor
- În formularele template-driven, scrie
namepe fiecare câmp cungModel, de obicei egal cu proprietatea legată. - Folosește nume unice: două câmpuri cu același
namese suprascriu înf.value. - Păstrează
standalone: truedoar pentru câmpuri care nu țin de datele trimise.
Întrebări frecvente
De ce în afara unui <form> merge fără name?
În afara unui formular nu există un NgForm în care câmpul să se înregistreze, deci ngModel lucrează singur, ca un control independent.
Name trebuie să fie egal cu numele variabilei?
Nu e obligatoriu, dar e convenția. name este cheia din f.value, iar variabila legată e separată. Dacă sunt egale, codul e mai ușor de citit.
Erori înrudite
NG0303: Can't bind to 'ngModel' since it isn't a known property of 'input'. Folosești [(ngModel)] fără să fi importat FormsModule în componentă, așa că Angular nu cunoaște directiva ngModel. Adaugă FormsModule în imports: [...] din @Component (sau în NgModule, la proiectele vechi). NG01350: ngModel cannot be used to register form controls with a parent formGroup directive. Try using formGroup's partner directive "formControlName" instead. Ai pus un câmp cu [(ngModel)] și name într-un formular reactiv ([formGroup]). Cele două stiluri nu se amestecă: adaugă câmpul ca FormControl în grup și leagă-l cu formControlName. NG01000: There are no form controls registered with this group yet. If you're using ngModel, you may want to check next tick (e.g. use setTimeout). Ai apelat setValue() pe un formular care încă nu are controale: de obicei un formular template-driven (ngForm) în ngOnInit sau ngAfterViewInit, înainte ca câmpurile cu ngModel să se înregistreze. Leagă valorile inițiale direct prin [(ngModel)] sau folosește patchValue. Î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.
