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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Într-o aplicație cu componente standalone, fiecare componentă își declară singură ce folosește în șablon, prin imports: [...]. Când compilatorul găsește tagul <app-card> și nicio componentă importată nu are selectorul app-card, nu știe ce e. La ng build / ng serve primești eroarea NG8001, iar în browser (JIT) avertismentul NG0304 în consolă, iar tagul rămâne un element HTML gol: cardul pur și simplu nu apare.
Mesajul îți dă două ipoteze: dacă e o componentă Angular, verifică @Component.imports; dacă e un Web Component (un element personalizat din altă bibliotecă), adaugă CUSTOM_ELEMENTS_SCHEMA la schemas.
Cauzele frecvente: ai uitat imports, ai importat clasa în fișier (cu import) dar nu și în decorator, selectorul diferă (app-card vs app-product-card), sau componenta e declarată într-un NgModule pe care nu l-ai importat.
De ce apare: cauzele frecvente
1Componenta nu e în imports
import { Card } from './card';
@Component({
selector: 'app-root',
template: `<app-card titlu="Mouse" />`
})import { Card } from './card';
@Component({
selector: 'app-root',
imports: [Card],
template: `<app-card titlu="Mouse" />`
})Instrucțiunea import din TypeScript doar aduce clasa în fișier; imports: [Card] o face disponibilă în șablon.
2Selectorul diferă de tagul folosit
@Component({ selector: 'app-product-card', ... })
export class Card {}
// șablon: <app-card />@Component({ selector: 'app-card', ... })
export class Card {}
// șablon: <app-card />Tagul din șablon trebuie să fie exact selectorul componentei.
3Web Component extern
@Component({
template: `<emoji-picker></emoji-picker>`
})import { CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
@Component({
schemas: [CUSTOM_ELEMENTS_SCHEMA],
template: `<emoji-picker></emoji-picker>`
})Pentru elemente personalizate care nu sunt componente Angular, schema îi spune compilatorului să le accepte.
Repară eroarea, direct în pagină
Pagina magazinului trebuie să afișeze componenta Card (din card.ts) cu titlul „Mouse wireless” și prețul 120 lei. Starter-ul dă avertismentul NG0304 „'app-card' is not a known element”, iar cardul nu apare. Repară componenta App.
import { Component } from '@angular/core';
import { Card } from './card';
@Component({
selector: 'app-root',
template: `
<h1>Oferta zilei</h1>
<app-card titlu="Mouse wireless" [pret]="120" />
`
})
export class App {}Indiciu
Adaugă Card în imports: [...] din @Component.
Reparația
import { Component } from '@angular/core';
import { Card } from './card';
@Component({
selector: 'app-root',
imports: [Card],
template: `
<h1>Oferta zilei</h1>
<app-card titlu="Mouse wireless" [pret]="120" />
`
})
export class App {}De ce merge
Instrucțiunea import { Card } from './card' aduce clasa în fișier, dar compilatorul de șabloane al lui App caută componentele doar în imports din decorator. Fără ea, <app-card> e un tag necunoscut: Angular avertizează cu NG0304 și lasă un element gol.
Cu imports: [Card], compilatorul leagă tagul de componentă, îi trimite input-urile titlu și pret, iar cardul apare cu datele lui.
Alte forme ale mesajului
NG8001: 'app-card' is not a known element: 1. If 'app-card' is an Angular component, then verify that it is included in the '@Component.imports' of this component.NG0304: 'app-card' is not a known element: 1. If 'app-card' is an Angular component, then verify that it is part of this module.'router-outlet' is not a known elementerror NG8001: 'mat-icon' is not a known element
Cum o eviți pe viitor
- Când adaugi un tag de componentă în șablon, adaugă imediat clasa în
imports(Angular Language Service propune automat importul). - Folosește
ng generate componentca selectorul și numele fișierului să fie consecvente. - Tratează avertismentele NG0304 din consolă ca pe erori: în build-ul de producție devin NG8001 și opresc compilarea.
- În componentele vechi cu
standalone: false, componenta trebuie declarată sau importată în NgModule-ul lor.
Întrebări frecvente
De ce în browser e doar un avertisment, iar la build e eroare?
În modul JIT, Angular nu poate fi sigur că elementul nu e un Web Component înregistrat mai târziu, așa că doar avertizează. Compilatorul AOT (ng build) cunoaște toate importurile și oprește build-ul cu NG8001.
Am importat componenta și tot primesc eroarea. Ce verific?
Că selectorul e exact tagul folosit, că ai adăugat clasa în imports al componentei care folosește tagul (nu al părintelui ei) și, pentru componente vechi cu standalone: false, că sunt exportate din NgModule-ul importat.
Erori înrudite
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]="...". NG8113: Card is not used within the template of App Ai pus o componentă, directivă sau un pipe în imports, dar șablonul nu-l folosește. E un avertisment de build: fie șterge importul inutil, fie (des) ai uitat să adaugi tagul componentei în șablon. TS2307: Cannot find module './card' or its corresponding type declarations. Calea din import nu duce la niciun fișier: fișierul e în alt folder, are alt nume (card.component.ts) sau ai greșit ./ și ../. Corectează calea relativă, fără extensia .ts: import { Card } from './components/card'; The "Card" component, imported from "App", is not standalone. Does the component have the standalone: false flag? În imports-ul unei componente standalone ai pus o componentă declarată cu standalone: false (care aparține unui NgModule). Fă-o standalone (șterge standalone: false) sau importă NgModule-ul care o exportă. Î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.
