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

NG0304: 'app-card' is not a known element (used in the 'App' component template)

Pe scurt

Ș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

Greșit
TypeScript
import { Card } from './card';

@Component({
  selector: 'app-root',
  template: `<app-card titlu="Mouse" />`
})
Corect
TypeScript
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

Greșit
TypeScript
@Component({ selector: 'app-product-card', ... })
export class Card {}
// șablon: <app-card />
Corect
TypeScript
@Component({ selector: 'app-card', ... })
export class Card {}
// șablon: <app-card />

Tagul din șablon trebuie să fie exact selectorul componentei.

3Web Component extern

Greșit
TypeScript
@Component({
  template: `<emoji-picker></emoji-picker>`
})
Corect
TypeScript
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ă tu

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.

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

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 element
  • error 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 component ca 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

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