RouterLinkActive

directive

npm Package @angular/router
Module import { RouterLinkActive } from '@angular/router';
Source router/src/directives/router_link_active.ts
NgModule RouterModule

Lets you add a CSS class to an element when the link's route becomes active.

Overview

@Directive({
    selector: '[routerLinkActive]',
    exportAs: 'routerLinkActive'
})
class RouterLinkActive implements OnChanges, OnDestroy, AfterContentInit {
  links: QueryList<RouterLink>
  linksWithHrefs: QueryList<RouterLinkWithHref>
  routerLinkActiveOptions: {exact: boolean}
  get isActive: boolean
  ngAfterContentInit(): void
  set routerLinkActive: string[]|string
  ngOnChanges(changes: SimpleChanges): void
  ngOnDestroy(): void
}

How To Use

<a routerLink="/user/bob" routerLinkActive="active-link">Bob</a>

Selectors

[routerLinkActive]

Inputs

routerLinkActiveOptions bound to RouterLinkActive.routerLinkActiveOptions

Exported as

Description

The RouterLinkActive directive lets you add a CSS class to an element when the link's route becomes active.

Consider the following example:

<a routerLink="/user/bob" routerLinkActive="active-link">Bob</a>

When the url is either '/user' or '/user/bob', the active-link class will be added to the a tag. If the url changes, the class will be removed.

You can set more than one class, as follows:

<a routerLink="/user/bob" routerLinkActive="class1 class2">Bob</a>
<a routerLink="/user/bob" [routerLinkActive]="['class1', 'class2']">Bob</a>

You can configure RouterLinkActive by passing exact: true. This will add the classes only when the url matches the link exactly.

<a routerLink="/user/bob" routerLinkActive="active-link" [routerLinkActiveOptions]="{exact:
true}">Bob</a>

You can assign the RouterLinkActive instance to a template variable and directly check the isActive status.

<a routerLink="/user/bob" routerLinkActive #rla="routerLinkActive">
  Bob {{ rla.isActive ? '(already open)' : ''}}
</a>

Finally, you can apply the RouterLinkActive directive to an ancestor of a RouterLink.

<div routerLinkActive="active-link" [routerLinkActiveOptions]="{exact: true}">
  <a routerLink="/user/jim">Jim</a>
  <a routerLink="/user/bob">Bob</a>
</div>

This will set the active-link class on the div tag if the url is either '/user/jim' or '/user/bob'.

Constructor

constructor(router: Router, element: ElementRef, renderer: Renderer2, cdr: ChangeDetectorRef)

Members

links: QueryList<RouterLink>

linksWithHrefs: QueryList<RouterLinkWithHref>

routerLinkActiveOptions: {exact: boolean}

get isActive: boolean

ngAfterContentInit(): void

set routerLinkActive: string[]|string

ngOnChanges(changes: SimpleChanges): void

ngOnDestroy(): void

© 2010–2017 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://v4.angular.io/api/router/RouterLinkActive