RouterLink

Stable Directive

Что это делает

Позволяет переходить к определённым частям вашего приложения.

Как использовать

Рассмотрите следующую конфигурацию маршрутов: [{ path: 'user/:name', component: UserCmp }]

При переходе на этот user/:name маршрут, можно написать: <a routerLink='/user/bob'>link to user component</a>

Обзор класса

class RouterLink {
  constructor(router: Router, route: ActivatedRoute)
  
  
  queryParams : {[k: string]: any}
  fragment : string
  preserveQueryParams : boolean
  preserveFragment : boolean
  skipLocationChange : boolean
  replaceUrl : boolean
  routerLink 
  onClick() : boolean
  urlTree : UrlTree
}

Селекторы

:not(a)[routerLink]

Описание класса

Директива RouterLink позволяет переходить к определённым частям вашего приложения.

Если ссылка статическая, можно использовать директиву следующим образом: <a routerLink="/user/bob">link to user component</a>

Если вы используете динамические значения для генерации ссылки, можно передать массив сегментов пути, а затем параметры для каждого сегмента.

Например, ['/team', teamId, 'user', userName, {details: true}] означает, что мы хотим сгенерировать ссылку на /team/11/user/bob;details=true.

Несколько статических сегментов можно объединить в один (например, ['/team/11/user', userName, {details: true}]).

Имя первого сегмента можно префиксровать с /, ./, или ../:

• Если первый сегмент начинается с /, маршрутизатор будет искать маршрут с корня приложения.
• Если первый сегмент начинается с ./, или не начинается с косой черты, маршрутизатор будет искать в дочерних элементах текущего активированного маршрута.
• И если первый сегмент начинается с ../, маршрутизатор перейдёт на уровень выше.

Вы можете задать параметры запроса и фрагмент следующим образом:

<a [routerLink]="['/user/bob']" [queryParams]="{debug: true}" fragment="education">
  link to user component
</a>

RouterLink будет использовать их для генерации этой ссылки: /user/bob#education?debug=true.

Вы также можете указать директиве сохранить текущие параметры запроса и фрагмент:

<a [routerLink]="['/user/bob']" preserveQueryParams preserveFragment>
  link to user component
</a>

Директива маршрутной ссылки всегда рассматривает предоставленный ввод как изменение к текущему URL.

Например, если текущий URL /user/(box//aux:team).

Тогда следующая ссылка <a [routerLink]="['/user/jim']">Jim</a> сгенерирует ссылку /user/(jim//aux:team).

Конструктор

constructor(router: Router, route: ActivatedRoute)

Подробности класса

queryParams : {[k: string]: any}

fragment : string

preserveQueryParams : boolean

preserveFragment : boolean

skipLocationChange : boolean

replaceUrl : boolean

routerLink

onClick() : boolean

urlTree : UrlTree

экспортировано из @angular/router/index, определено в @angular/router/src/directives/router_link.ts