...
Eroare Angular · Componente, imports și selectoare

NG0303: Can't bind to 'nume' since it isn't a known property of 'app-card' (used in the 'App' component template).

Pe scurt

Ș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]="...".

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

Ce înseamnă

Un binding [x]="..." pe tagul unei componente trimite valoarea către input-ul x al componentei. Angular caută x printre input-urile componentei (declarate cu input(), input.required(), model() sau @Input()) și printre proprietățile DOM ale elementului. Dacă nu-l găsește nicăieri, la rulare afișează avertismentul NG0303, iar la ng build eroarea NG8002. Valoarea nu ajunge în componentă, care rămâne cu valoarea implicită.

Mesajul îți dă trei ipoteze: componenta are input-ul dar nu e în imports; e un Web Component (CUSTOM_ELEMENTS_SCHEMA); sau vrei să permiți orice proprietate (NO_ERRORS_SCHEMA, rar o idee bună).

Cazurile [(ngModel)], [formGroup] și [routerLink] au aceeași formă de mesaj, dar alte cauze (lipsesc FormsModule, ReactiveFormsModule, RouterLink).

De ce apare: cauzele frecvente

1Numele input-ului diferă

Greșit
TypeScript
// card.ts
titlu = input('');
// app.ts
<app-card [nume]="produs.nume" />
Corect
TypeScript
// card.ts
titlu = input('');
// app.ts
<app-card [titlu]="produs.nume" />

Numele din binding trebuie să fie numele input-ului (sau aliasul lui).

2Proprietate fără input()

Greșit
TypeScript
export class Card {
  titlu = '';
}
Corect
TypeScript
export class Card {
  titlu = input('');
}

Un câmp obișnuit nu poate primi valori din părinte. Trebuie declarat cu input() (sau @Input() în stilul vechi).

3Alias folosit în altă parte

Greșit
TypeScript
titlu = input('', { alias: 'eticheta' });
// șablon părinte:
<app-card [titlu]="x" />
Corect
TypeScript
titlu = input('', { alias: 'eticheta' });
// șablon părinte:
<app-card [eticheta]="x" />

Cu alias, din exterior input-ul se numește doar după alias.

Repară tu

Repară eroarea, direct în pagină

Componenta Card (din card.ts) are input-urile titlu și pret. Starter-ul îi trimite [nume], dă avertismentul NG0303 „Can't bind to 'nume'” și cardul nu afișează titlul. Repară binding-ul ca .titlu să afișeze „Căști Bluetooth”.

Codul care dă eroarea
TypeScript
import { Component } from '@angular/core';
import { Card } from './card';

@Component({
  selector: 'app-root',
  imports: [Card],
  template: `<app-card [nume]="produs.nume" [pret]="produs.pret" />`
})
export class App {
  produs = { nume: 'Căști Bluetooth', pret: 250 };
}
Indiciu

Folosește numele input-ului din card.ts: titlu.

Alte forme ale mesajului

  • NG8002: Can't bind to 'nume' since it isn't a known property of 'app-card'.
  • NG8002: Can't bind to 'nume' since it isn't a known property of 'app-card'. 1. If 'app-card' is an Angular component and it has 'nume' input, then verify that it is included in the '@Component.imports' of this component.
  • Can't bind to 'produs' since it isn't a known property of 'app-product-card'.

Cum o eviți pe viitor

  • Când scrii binding-ul, lasă editorul să-ți propună input-urile componentei (Angular Language Service).
  • Ține numele input-urilor scurte și consecvente între componente (produs, titlu).
  • Folosește alias doar când chiar ai nevoie de alt nume public.
  • Nu „repara” avertismentul cu NO_ERRORS_SCHEMA: ascunde și greșelile reale.

Întrebări frecvente

De ce nu primesc eroare, doar avertisment, și componenta afișează valoarea implicită?

În modul JIT (browser, fără build AOT), NG0303 e un avertisment de dezvoltare: valoarea e ignorată și componenta folosește valoarea implicită. La ng build aceeași greșeală e eroare NG8002 și oprește build-ul.

Am redenumit input-ul și acum am eroarea în mai multe locuri. Cum le găsesc?

ng build le listează pe toate, cu fișierul și rândul. În editor, redenumirea cu F2 pe input() actualizează și binding-urile din șabloane.

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.