...
Eroare Angular · Router și navigare

NG0303: Can't bind to 'routerLink' since it isn't a known property of 'a' (used in the 'App' component template).

Pe scurt

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

Greșit
TypeScript
@Component({
  selector: 'app-root',
  imports: [RouterOutlet],
  template: `<a [routerLink]="['/cos']">Coș</a>`
})
Corect
TypeScript
@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

Greșit
TypeScript
@Component({
  selector: 'app-meniu',
  template: `<a routerLink="/produse">Produse</a>`
})
export class Meniu {}
Corect
TypeScript
@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

Greșit
TypeScript
imports: [RouterLink],
template: `<a routerLink="/" routerLinkActive="activ" [routerLinkActiveOptions]="{ exact: true }">Acasă</a>`
Corect
TypeScript
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ă tu

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

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

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 (plus RouterLinkActive dacă marchezi linkul activ) în imports.
  • 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

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