...
Eroare Angular · Router și navigare

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

Pe scurt

Componenta folosește <router-outlet /> în șablon, dar nu are RouterOutlet în imports. Adaugă RouterOutlet (din @angular/router) în imports: [...] din @Component; altfel paginile nu apar deloc.

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

Ce înseamnă

Într-o componentă standalone, șablonul poate folosi doar elementele și directivele pe care componenta le importă explicit. <router-outlet> e directiva RouterOutlet din @angular/router; dacă lipsește din imports, Angular vede un tag necunoscut.

În modul de dezvoltare primești NG0304 în consolă (ca avertisment), iar la ng build / ng serve compilatorul AOT dă eroarea NG8001: 'router-outlet' is not a known element. Aplicația pornește, dar locul în care ar trebui să apară paginile rămâne gol: routerul schimbă adresa, însă nu are unde să afișeze componenta.

Textul (used in the 'App' component template) îți spune componenta care trebuie reparată. De obicei e App (componenta principală), dar la rutele copil e componenta părinte care are propriul <router-outlet />.

De ce apare: cauzele frecvente

1RouterOutlet lipsește din imports

Greșit
TypeScript
@Component({
  selector: 'app-root',
  template: `<router-outlet />`
})
export class App {}
Corect
TypeScript
import { RouterOutlet } from '@angular/router';

@Component({
  selector: 'app-root',
  imports: [RouterOutlet],
  template: `<router-outlet />`
})
export class App {}

imports spune compilatorului ce directive poate folosi șablonul. Cu RouterOutlet importat, tagul devine locul în care apar paginile.

2Outlet în componenta părinte a rutelor copil

Greșit
TypeScript
@Component({
  selector: 'app-cont',
  imports: [RouterLink],
  template: `<nav>...</nav><router-outlet />`
})
export class Cont {}
Corect
TypeScript
@Component({
  selector: 'app-cont',
  imports: [RouterLink, RouterOutlet],
  template: `<nav>...</nav><router-outlet />`
})
export class Cont {}

Fiecare componentă care are un outlet trebuie să-l importe ea însăși; importul din App nu se moștenește.

3Proiect vechi cu NgModule fără RouterModule

Greșit
TypeScript
@NgModule({
  declarations: [AppComponent],
  imports: [BrowserModule]
})
export class AppModule {}
Corect
TypeScript
@NgModule({
  declarations: [AppComponent],
  imports: [BrowserModule, RouterModule.forRoot(routes)]
})
export class AppModule {}

În aplicațiile cu NgModule, RouterModule face cunoscute router-outlet și routerLink componentelor declarate în modul.

Repară tu

Repară eroarea, direct în pagină

Aplicația pornește la /contact, dar sub titlu nu apare nimic, iar consola arată „NG0304: 'router-outlet' is not a known element”. Repară componenta App ca pagina Contact (titlul h2 „Contactează-ne”) să apară în outlet.

Codul care dă eroarea
TypeScript
import { Component } from '@angular/core';
import { Routes, RouterLink } from '@angular/router';

@Component({ selector: 'app-contact', template: `<h2>Contactează-ne</h2><p>Str. Lalelelor 7, Sibiu</p>` })
export class Contact {}

export const routes: Routes = [{ path: 'contact', component: Contact }];

@Component({
  selector: 'app-root',
  imports: [RouterLink],
  template: `
    <h1>Florăria Lalea</h1>
    <a routerLink="/contact">Contact</a>
    <router-outlet />
  `
})
export class App {}
Indiciu

Directiva din spatele tagului <router-outlet> trebuie importată în componentă.

Alte forme ale mesajului

  • NG8001: 'router-outlet' is not a known element: 1. If 'router-outlet' is an Angular component, then verify that it is included in the '@Component.imports' of this component.
  • error NG8001: 'router-outlet' is not a known element
  • 'router-outlet' is not a known element: 1. If 'router-outlet' is an Angular component, then verify that it is part of this module.

Cum o eviți pe viitor

  • Când creezi componenta principală, adaugă RouterOutlet în imports imediat ce pui <router-outlet /> în șablon (așa o generează și ng new).
  • Ține un ochi pe consola din browser: avertismentele NG0304 / NG0303 apar la pornire și îți spun exact ce import lipsește.
  • La rutele copil, verifică și componenta părinte: are nevoie de propriul RouterOutlet în imports.

Întrebări frecvente

De ce aplicația pornește, dar paginile nu apar?

În JIT/dezvoltare, un element necunoscut e doar un avertisment, iar <router-outlet> rămâne un tag HTML gol. Routerul schimbă adresa, dar nu există niciun outlet înregistrat în care să pună componenta.

Trebuie să import RouterModule într-o componentă standalone?

Nu e nevoie. Importă doar ce folosești: RouterOutlet, RouterLink, RouterLinkActive. Rutele se configurează o singură dată, cu provideRouter(routes) în app.config.ts.

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.