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]="...".
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ă
// card.ts
titlu = input('');
// app.ts
<app-card [nume]="produs.nume" />// 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()
export class Card {
titlu = '';
}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
titlu = input('', { alias: 'eticheta' });
// șablon părinte:
<app-card [titlu]="x" />titlu = input('', { alias: 'eticheta' });
// șablon părinte:
<app-card [eticheta]="x" />Cu alias, din exterior input-ul se numește doar după alias.
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”.
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.
Reparația
import { Component } from '@angular/core';
import { Card } from './card';
@Component({
selector: 'app-root',
imports: [Card],
template: `<app-card [titlu]="produs.nume" [pret]="produs.pret" />`
})
export class App {
produs = { nume: 'Căști Bluetooth', pret: 250 };
}De ce merge
Binding-ul [nume] caută un input numit nume în Card. Componenta are doar titlu și pret, iar elementul nu are nici proprietatea DOM nume, deci Angular avertizează cu NG0303 și ignoră valoarea: titlul rămâne textul gol implicit.
Cu [titlu], valoarea produs.nume ajunge în input-ul titlu() al cardului, iar șablonul lui o afișează în .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
aliasdoar 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
NG0304: 'app-card' is not a known element (used in the 'App' component template) Șablonul folosește tagul <app-card>, dar componenta care are acest selector nu e în imports-ul componentei curente (sau selectorul e scris diferit). Importă clasa și adaug-o în imports: [Card] din @Component. NG0303: Can't bind to 'colspan' since it isn't a known property of 'td' (used in the 'App' component template). [colspan] leagă o proprietate DOM, dar elementul td are proprietatea colSpan, nu colspan. Pentru atribute HTML fără proprietate cu același nume (colspan, rowspan, aria-*, data-*), folosește [attr.colspan]="n". NG0950: Input is required but no value is available yet. Un input.required() a fost citit înainte să primească valoare: părintele nu-l trimite deloc, sau componenta îl citește în constructor ori la inițializarea unui câmp. Trimite-l din părinte și citește-l doar în șablon, computed() sau ngOnInit. TS2322: Type 'string' is not assignable to type 'number'. Un input de tip number primește un text: <app-card pret="25" /> trimite șirul "25", nu numărul 25. Folosește binding de proprietate, [pret]="25", sau transformă atributul cu input(0, { transform: numberAttribute }). Î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.
