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

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

Pe scurt

Legi un câmp cu [formControl]="..." fără să fi importat ReactiveFormsModule în componentă. Adaugă ReactiveFormsModule în imports: [...], iar câmpul se va lega de FormControl-ul din clasă.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

[formControl] leagă un singur câmp de un FormControl creat în clasă, fără un FormGroup în jur. Este des folosit pentru câmpuri de căutare sau filtre, unde ascultă valueChanges. Directiva vine din ReactiveFormsModule; fără el, Angular nu o cunoaște și raportează că formControl nu este o proprietate a lui <input>.

La build primești NG8002 și compilarea se oprește; în rulare JIT primești avertismentul NG0303, iar câmpul nu e legat: valueChanges nu emite nimic și control.value rămâne valoarea inițială.

Atenție la confuzia dintre formControl și formControlName: primul primește chiar obiectul ([formControl]="cautare"), al doilea primește numele unui control dintr-un grup (formControlName="cautare") și are nevoie de un [formGroup] părinte.

De ce apare: cauzele frecvente

1Lipsește importul modulului

Greșit
TypeScript
@Component({
  template: `<input [formControl]="cautare" />`
})
export class App { cautare = new FormControl(''); }
Corect
TypeScript
@Component({
  imports: [ReactiveFormsModule],
  template: `<input [formControl]="cautare" />`
})
export class App { cautare = new FormControl(''); }

Modulul aduce directiva care leagă câmpul de obiectul FormControl.

2Ai scris formControlName în loc de formControl

Greșit
TypeScript
<input [formControlName]="cautare" />
Corect
TypeScript
<input [formControl]="cautare" />

formControlName cere un grup părinte și un nume; pentru un control independent folosești [formControl].

Repară tu

Repară eroarea, direct în pagină

Câmpul de căutare #cautare folosește [formControl], dar componenta nu importă modulul necesar și consola arată „Can't bind to 'formControl'”. Repară importul ca, după ce scrii „Dune”, p#termen să afișeze „Cauți: Dune”.

Codul care dă eroarea
TypeScript
import { Component } from '@angular/core';
import { FormControl } from '@angular/forms';

@Component({
  selector: 'app-root',
  template: `
    <input id="cautare" [formControl]="cautare" placeholder="Caută o carte" />
    <p id="termen">Cauți: {{ cautare.value }}</p>
  `
})
export class App {
  cautare = new FormControl('');
}
Indiciu

Directiva [formControl] face parte din formularele reactive.

Alte forme ale mesajului

  • error NG8002: Can't bind to 'formControl' since it isn't a known property of 'input'.
  • Can't bind to 'formControl' since it isn't a known property of 'select'.

Cum o eviți pe viitor

  • Orice componentă care folosește [formControl], [formGroup] sau formControlName are nevoie de ReactiveFormsModule în imports.
  • Pentru câmpuri independente (căutare, filtre) folosește [formControl]; pentru câmpuri din formulare, formControlName în [formGroup].
  • Lasă editorul (Angular Language Service) să-ți arate directivele necunoscute încă din șablon.

Întrebări frecvente

De ce valueChanges nu emite nimic?

Fără directiva din ReactiveFormsModule, câmpul din pagină nu e conectat la FormControl. Controlul există în clasă, dar nimeni nu-i transmite ce scrii.

Pot folosi un FormControl fără formular?

Da. [formControl] e gândit exact pentru asta: un câmp singur, cu validare și valueChanges, fără FormGroup.

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.