NG0304: 'router-outlet' is not a known element (used in the 'App' component template)
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
@Component({
selector: 'app-root',
template: `<router-outlet />`
})
export class App {}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
@Component({
selector: 'app-cont',
imports: [RouterLink],
template: `<nav>...</nav><router-outlet />`
})
export class Cont {}@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
@NgModule({
declarations: [AppComponent],
imports: [BrowserModule]
})
export class AppModule {}@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ă 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.
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ă.
Reparația
import { Component } from '@angular/core';
import { Routes, RouterLink, RouterOutlet } 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, RouterOutlet],
template: `
<h1>Florăria Lalea</h1>
<a routerLink="/contact">Contact</a>
<router-outlet />
`
})
export class App {}De ce merge
Tagul <router-outlet> este o directivă, nu un element HTML. Într-o componentă standalone, Angular recunoaște în șablon doar directivele din imports, așa că fără RouterOutlet tagul rămâne un element gol și primești avertismentul NG0304.
După import, outlet-ul se înregistrează la router. Când adresa este /contact, routerul găsește ruta, creează componenta Contact și o pune imediat după outlet, deci titlul apare sub meniu.
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înimportsimediat ce pui<router-outlet />în șablon (așa o generează șing 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înimports.
Î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
NG0303: Can't bind to 'routerLink' since it isn't a known property of 'a' (used in the 'App' component template). Folosești [routerLink] într-o componentă care nu importă directiva RouterLink. Adaugă RouterLink (din @angular/router) în imports: [...] din @Component; altfel linkul nu navighează. NG04002: Cannot match any routes. URL Segment: 'contact' Routerul a primit o adresă (aici /contact) pentru care nu există nicio rută în configurație. Adaugă ruta lipsă în Routes, corectează linkul sau pune la final o rută '**' pentru pagina 404. NullInjectorError: R3InjectorError(Standalone[App])[ActivatedRoute -> ActivatedRoute]: NullInjectorError: No provider for ActivatedRoute! O componentă injectează ActivatedRoute (sau RouterLink, RouterOutlet), dar aplicația nu are routerul configurat. Adaugă provideRouter(routes) în providers din app.config.ts sau din bootstrapApplication. 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. Î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.
