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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
[routerLink]="..." este un binding de proprietate. Angular caută o proprietate sau un input cu numele routerLink pe elementul <a>. Nici elementul HTML, nici vreo directivă importată nu o are, deci primești Can't bind to 'routerLink' since it isn't a known property of 'a'.
În dezvoltare (JIT) apare ca avertismentul NG0303 în consolă și aplicația merge mai departe, dar linkul nu mai face nimic. La ng build / ng serve compilatorul AOT îl raportează ca eroarea NG8002 și build-ul se oprește.
Mai e o capcană: forma fără paranteze, routerLink="/cos", nu dă niciun mesaj când lipsește importul, pentru că e un simplu atribut HTML. Linkul pare în regulă, dar nu are href și nu navighează. În ambele cazuri reparația e aceeași: RouterLink în imports.
De ce apare: cauzele frecvente
1RouterLink lipsește din imports
@Component({
selector: 'app-root',
imports: [RouterOutlet],
template: `<a [routerLink]="['/cos']">Coș</a>`
})@Component({
selector: 'app-root',
imports: [RouterOutlet, RouterLink],
template: `<a [routerLink]="['/cos']">Coș</a>`
})Cu RouterLink importat, routerLink devine inputul unei directive care pune href și navighează la click.
2Link într-o componentă copil
@Component({
selector: 'app-meniu',
template: `<a routerLink="/produse">Produse</a>`
})
export class Meniu {}@Component({
selector: 'app-meniu',
imports: [RouterLink],
template: `<a routerLink="/produse">Produse</a>`
})
export class Meniu {}Importurile nu se moștenesc de la App: fiecare componentă standalone își importă singură directivele.
3routerLinkActive fără directiva lui
imports: [RouterLink],
template: `<a routerLink="/" routerLinkActive="activ" [routerLinkActiveOptions]="{ exact: true }">Acasă</a>`imports: [RouterLink, RouterLinkActive],
template: `<a routerLink="/" routerLinkActive="activ" [routerLinkActiveOptions]="{ exact: true }">Acasă</a>`routerLinkActive este altă directivă; fără ea, [routerLinkActiveOptions] dă același tip de mesaj.
Repară eroarea, direct în pagină
Butonul-link #l-cos ar trebui să ducă la pagina coșului, dar la click nu se întâmplă nimic, iar consola arată „NG0303: Can't bind to 'routerLink' since it isn't a known property of 'a'”. Repară App ca după click adresa să fie /cos și să apară titlul „Coșul tău”.
import { Component } from '@angular/core';
import { Routes, RouterOutlet, RouterLink } from '@angular/router';
@Component({ selector: 'app-cos', template: `<h2>Coșul tău</h2><p>2 produse, 148 lei</p>` })
export class Cos {}
export const routes: Routes = [{ path: 'cos', component: Cos }];
@Component({
selector: 'app-root',
imports: [RouterOutlet],
template: `
<a id="l-cos" [routerLink]="['/cos']">Vezi coșul</a>
<router-outlet />
`
})
export class App {}Indiciu
Directiva care înțelege [routerLink] trebuie importată în componentă.
Reparația
import { Component } from '@angular/core';
import { Routes, RouterOutlet, RouterLink } from '@angular/router';
@Component({ selector: 'app-cos', template: `<h2>Coșul tău</h2><p>2 produse, 148 lei</p>` })
export class Cos {}
export const routes: Routes = [{ path: 'cos', component: Cos }];
@Component({
selector: 'app-root',
imports: [RouterOutlet, RouterLink],
template: `
<a id="l-cos" [routerLink]="['/cos']">Vezi coșul</a>
<router-outlet />
`
})
export class App {}De ce merge
Fără RouterLink în imports, [routerLink] nu aparține niciunei directive, iar <a> nu are o proprietate cu acest nume. Angular afișează NG0303 și ignoră binding-ul, deci linkul nu are href și click-ul nu face nimic.
Cu directiva importată, [routerLink]="['/cos']" devine inputul ei: directiva calculează href="/cos" și, la click, cere routerului să navigheze fără să reîncarce pagina.
Alte forme ale mesajului
NG8002: Can't bind to 'routerLink' since it isn't a known property of 'a'.error NG8002: Can't bind to 'routerLink' since it isn't a known property of 'button'.NG0303: Can't bind to 'routerLinkActiveOptions' since it isn't a known property of 'a' (used in the 'App' component template).
Cum o eviți pe viitor
- Când adaugi primul link într-o componentă, adaugă pe loc și
RouterLink(plusRouterLinkActivedacă marchezi linkul activ) înimports. - Verifică în pagină că linkul are
href: un<a routerLink>fărăhrefînseamnă că directiva nu e importată. - Rulează din când în când
ng build: erorile NG8002 apar acolo chiar dacă în dezvoltare ai văzut doar un avertisment.
Întrebări frecvente
De ce routerLink="/cos" nu dă eroare, dar nici nu merge?
Fără paranteze drepte e un atribut HTML obișnuit, pe care browserul îl ignoră. Abia când RouterLink e importat, Angular îl tratează ca input al directivei și transformă linkul într-unul de navigare.
Pot folosi href în loc de routerLink?
Poți, dar href reîncarcă toată aplicația la fiecare click și pierzi starea din memorie. routerLink schimbă doar componenta din outlet, fără reîncărcare.
Erori înrudite
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. 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. NG04008: The requested path contains undefined segment at index 1 Ai apelat router.navigate(['/produs', id]) cu un id undefined (sau null). Verifică de unde vine valoarea: de obicei un câmp scris greșit (p.cod în loc de p.id) sau date care nu au sosit încă. 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]="...". Î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.
