RouterLinkActive
当此链接指向的路由激活时,往宿主元素上添加一个 CSS 类。
Lets you add a CSS class to an element when the link's route becomes active.
NgModule
选择器
属性
属性 | 说明 |
---|---|
links: QueryList<RouterLink> | |
linksWithHrefs: QueryList<RouterLinkWithHref> | |
isActive: boolean | 只读 |
@Input() | |
@Input() | Write-only. |
模板变量参考手册
标识符 | 用途 |
---|---|
routerLinkActive | #myTemplateVar="routerLinkActive" |
说明
当此链接指向的路由激活时,该指令就会往宿主元素上添加一个 CSS 类。
This 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>
当浏览器的当前 url 是 '/user' 或 '/user/bob' 时,就会往 a
标签上添加 active-link
类; 如果 url 发生了变化,则移除它。
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>
你可以通过传入 exact: true
来配置 RouterLinkActive。这样,只有当 url 和此链接精确匹配时才会添加这些类。
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>
你可以把 RouterLinkActive
的实例赋给一个模板变量,以直接检查 isActive
的状态。
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>
最后,你还可以把 RouterLinkActive
指令用在 RouterLink
的各级祖先节点上。
Finally, you can apply the RouterLinkActive directive to an ancestor of a RouterLink.
<div routerLinkActive="active-link">
<a routerLink="/user/jim">Jim</a>
<a routerLink="/user/bob">Bob</a>
</div>
这样,无论当前 url 是 '/user/jim' 还是 '/user/bob',都会往 div
标签上添加一个 active-link
类。
This will set the active-link class on the div tag if the url is either '/user/jim' or '/user/bob'.
方法
参数没有参数。 返回值
|
参数没有参数。 返回值
|