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

NG0303: Can't bind to 'ngModel' since it isn't a known property of 'input'.

Pe scurt

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

Greșit
TypeScript
@Component({
  selector: 'app-root',
  template: `<input [(ngModel)]="nume" />`
})
Corect
TypeScript
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

Greșit
TypeScript
imports: [ReactiveFormsModule],
template: `<input [(ngModel)]="nume" />`
Corect
TypeScript
imports: [FormsModule],
template: `<input [(ngModel)]="nume" />`

ReactiveFormsModule conține directivele formularelor reactive (formControl, formGroup), nu ngModel.

3Componentă din NgModule fără FormsModule

Greșit
TypeScript
@NgModule({
  declarations: [Profil],
  imports: [CommonModule]
})
Corect
TypeScript
@NgModule({
  declarations: [Profil],
  imports: [CommonModule, FormsModule]
})

În proiectele vechi, importurile se fac pe modulul care declară componenta, nu pe modulul aplicației.

Repară tu

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

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

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ă imediat FormsModule în imports.
  • Nu amesteca: template-driven = FormsModule, reactive = ReactiveFormsModule.
  • Rulează ng serve cu verificarea strictă a șabloanelor: eroarea apare la compilare, cu fișierul și linia.
  • Când copiezi un formular dintr-un tutorial, verifică și lista imports a 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

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