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

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.

Pe scurt

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

Greșit
TypeScript
<form #f="ngForm">
  <input [(ngModel)]="client.email" />
</form>
Corect
TypeScript
<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

Greșit
TypeScript
<form #f="ngForm">
  <input type="checkbox" [(ngModel)]="aratParola" />
</form>
Corect
TypeScript
<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ă tu

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

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

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 name pe fiecare câmp cu ngModel, de obicei egal cu proprietatea legată.
  • Folosește nume unice: două câmpuri cu același name se suprascriu în f.value.
  • Păstrează standalone: true doar 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

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