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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
[(ngModel)] nu este o funcționalitate de bază a șabloanelor, ci o directivă din pachetul @angular/forms. Ca orice directivă, trebuie importată în componentele care o folosesc. Fără import, Angular vede [ngModel] ca pe o proprietate a elementului <input>, iar input nu are o proprietate cu acest nume, de unde mesajul „isn't a known property of 'input'”.
La ng build / ng serve eroarea apare la compilare (NG8002) și oprește build-ul. În rulare JIT apare ca avertisment NG0303 în consolă, iar câmpul pur și simplu nu se leagă: ce scrii nu ajunge în variabilă.
În componentele standalone (implicite în Angular modern), adaugi FormsModule în imports: [...] din @Component. În proiectele vechi cu NgModule, îl adaugi în imports al modulului care declară componenta. Același mesaj apare și pe <select> sau <textarea> (isn't a known property of 'select').
De ce apare: cauzele frecvente
1FormsModule lipsă din imports
@Component({
selector: 'app-root',
template: `<input [(ngModel)]="nume" />`
})import { FormsModule } from '@angular/forms';
@Component({
selector: 'app-root',
imports: [FormsModule],
template: `<input [(ngModel)]="nume" />`
})FormsModule aduce directiva NgModel, care știe să lege valoarea câmpului de variabilă în ambele direcții.
2Ai importat ReactiveFormsModule în loc de FormsModule
imports: [ReactiveFormsModule],
template: `<input [(ngModel)]="nume" />`imports: [FormsModule],
template: `<input [(ngModel)]="nume" />`ReactiveFormsModule conține directivele formularelor reactive (formControl, formGroup), nu ngModel.
3Componentă din NgModule fără FormsModule
@NgModule({
declarations: [Profil],
imports: [CommonModule]
})@NgModule({
declarations: [Profil],
imports: [CommonModule, FormsModule]
})În proiectele vechi, importurile se fac pe modulul care declară componenta, nu pe modulul aplicației.
Repară eroarea, direct în pagină
Câmpul #nume este legat cu [(ngModel)], dar componenta nu are directiva importată, iar consola arată „Can't bind to 'ngModel'”. Repară componenta ca, după ce scrii „Ion” în câmp, p#salut să afișeze „Salut, Ion!”.
import { Component } from '@angular/core';
@Component({
selector: 'app-root',
template: `
<input id="nume" [(ngModel)]="nume" />
<p id="salut">Salut, {{ nume }}!</p>
`
})
export class App {
nume = '';
}Indiciu
Directiva ngModel vine dintr-un modul din @angular/forms.
Reparația
import { Component } from '@angular/core';
import { FormsModule } from '@angular/forms';
@Component({
selector: 'app-root',
imports: [FormsModule],
template: `
<input id="nume" [(ngModel)]="nume" />
<p id="salut">Salut, {{ nume }}!</p>
`
})
export class App {
nume = '';
}De ce merge
Fără FormsModule, Angular nu cunoștea directiva NgModel și trata [ngModel] ca pe o proprietate necunoscută a lui <input>. A afișat avertismentul NG0303 și a ignorat legătura, deci textul scris nu ajungea în nume.
Cu FormsModule în imports, directiva există: [(ngModel)] scrie valoarea din câmp în nume la fiecare tastă și invers, iar paragraful afișează salutul.
Alte forme ale mesajului
error NG8002: Can't bind to 'ngModel' since it isn't a known property of 'input'.Can't bind to 'ngModel' since it isn't a known property of 'select'.NG0303: Can't bind to 'ngModel' since it isn't a known property of 'textarea' (used in the 'App' component template).
Cum o eviți pe viitor
- Când folosești
ngModelîntr-o componentă nouă, adaugă imediatFormsModuleînimports. - Nu amesteca: template-driven =
FormsModule, reactive =ReactiveFormsModule. - Rulează
ng servecu verificarea strictă a șabloanelor: eroarea apare la compilare, cu fișierul și linia. - Când copiezi un formular dintr-un tutorial, verifică și lista
importsa componentei de unde l-ai luat.
Întrebări frecvente
De ce nu e FormsModule inclus automat?
Angular include în fiecare componentă doar ce imporți explicit, ca aplicația să conțină numai codul folosit. Formularele sunt un pachet separat, opțional.
Pot folosi signals în loc de ngModel?
Da: [value]="nume()" cu (input)="nume.set($any($event.target).value)", sau Signal Forms (@angular/forms/signals). [(ngModel)] rămâne însă cea mai scurtă variantă pentru formulare simple.
Erori înrudite
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). 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. NG0303: Can't bind to 'formGroup' since it isn't a known property of 'form'. Folosești [formGroup] fără ReactiveFormsModule importat în componentă, așa că Angular nu cunoaște directiva. Adaugă ReactiveFormsModule în imports: [...] din @Component (FormsModule nu ajunge). NG0303: Can't bind to 'nume' since it isn't a known property of 'app-card' (used in the 'App' component template). Șablonul trimite [nume] către <app-card>, dar componenta Card nu are un input cu acest nume (îl cheamă altfel, nu e declarat cu input(), sau componenta nu e importată). Folosește exact numele input-ului: [titlu]="...". Î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.
