本主题讲述当把 Angular 路由器添加到应用中时,如何实现多种常见路由任务。
下面的命令会用 Angular CLI 来生成一个带有应用路由模块(AppRoutingModule
)的基本 Angular 应用,它是一个 NgModule,可用来配置路由。下面的例子中应用的名字是 routing-app
。
ng new routing-app --routing --defaults
为了使用 Angular 的路由器,应用至少要有两个组件才能从一个导航到另一个。要使用 CLI 创建组件,请在命令行输入以下内容,其中 first
是组件的名称:
ng generate component first
为第二个组件重复这个步骤,但给它一个不同的名字。这里的新名字是 second
。
ng generate component second
CLI 会自动添加 Component
后缀,所以如果在编写 first-component
,那么其组件名就是 FirstComponentComponent
。
<base href>
本指南适用于 CLI 生成的 Angular 应用。如果你是手动工作的,请确保你的 index.html 文件的 <head>
中有 <base href="/">
语句。这里假定 app
文件夹是应用的根目录,并使用 "/"
作为基础路径。
要使用这些新组件,请把它们导入到该文件顶部的 AppRoutingModule
中,具体如下:
import { FirstComponent } from "./first/first.component";
import { SecondComponent } from "./second/second.component";
创建路由有三个基本的构建块。
把 AppRoutingModule
导入 AppModule
并把它添加到 imports
数组中。
Angular CLI 会为你执行这一步骤。但是,如果要手动创建应用或使用现存的非 CLI 应用,请验证导入和配置是否正确。下面是使用 --routing
标志生成的默认 AppModule
。
import { BrowserModule } from "@angular/platform-browser";
import { NgModule } from "@angular/core";
import { AppRoutingModule } from "./app-routing.module"; // CLI imports AppRoutingModule
import { AppComponent } from "./app.component";
@NgModule({
declarations: [
AppComponent
],
imports: [
BrowserModule,
AppRoutingModule // CLI adds AppRoutingModule to the AppModule"s imports array
],
providers: [],
bootstrap: [AppComponent]
})
export class AppModule { }
RouterModule
和 Routes
导入到你的路由模块中。Angular CLI 会自动执行这一步骤。CLI 还为你的路由设置了 Routes
数组,并为 @NgModule()
配置了 imports
和 exports
数组。
import { NgModule } from "@angular/core";
import { Routes, RouterModule } from "@angular/router"; // CLI imports router
const routes: Routes = []; // sets up routes constant where you define your routes
// configures NgModule imports and exports
@NgModule({
imports: [RouterModule.forRoot(routes)],
exports: [RouterModule]
})
export class AppRoutingModule { }
Routes
数组中定义你的路由。这个数组中的每个路由都是一个包含两个属性的 JavaScript 对象。第一个属性 path
定义了该路由的 URL 路径。第二个属性 component
定义了要让 Angular 用作相应路径的组件。
const routes: Routes = [
{ path: "first-component", component: FirstComponent },
{ path: "second-component", component: SecondComponent },
];
现在你已经定义了路由,可以把它们添加到应用中了。首先,添加到这两个组件的链接。把要添加路由的链接赋值给 routerLink
属性。将属性的值设置为该组件,以便在用户点击各个链接时显示这个值。接下来,修改组件模板以包含 <router-outlet>
标签。该元素会通知 Angular,你可以用所选路由的组件更新应用的视图。
<h1>Angular Router App</h1>
<!-- This nav gives you links to click, which tells the router which route to use (defined in the routes constant in AppRoutingModule) -->
<nav>
<ul>
<li><a routerLink="/first-component" routerLinkActive="active">First Component</a></li>
<li><a routerLink="/second-component" routerLinkActive="active">Second Component</a></li>
</ul>
</nav>
<!-- The routed views render in the <router-outlet>-->
<router-outlet></router-outlet>
路由的顺序很重要,因为 Router
在匹配路由时使用“先到先得”策略,所以应该在不那么具体的路由前面放置更具体的路由。首先列出静态路径的路由,然后是一个与默认路由匹配的空路径路由。通配符路由是最后一个,因为它匹配每一个 URL,只有当其它路由都没有匹配时,Router
才会选择它。
通常,当用户导航你的应用时,你会希望把信息从一个组件传递到另一个组件。例如,考虑一个显示杂货商品购物清单的应用。列表中的每一项都有一个唯一的 id
。要想编辑某个项目,用户需要单击“编辑”按钮,打开一个 EditGroceryItem
组件。你希望该组件得到该商品的 id
,以便它能向用户显示正确的信息。
可以用一个路由把这种类型的信息传给你的应用组件。要做到这一点,你可以使用 ActivatedRoute
接口。
要从路由中获取信息:
ActivatedRoute
和 ParamMap
导入你的组件。import { Router, ActivatedRoute, ParamMap } from "@angular/router";
这些 import 语句添加了组件所需的几个重要元素。
ActivatedRoute
的一个实例添加到你的应用的构造函数中来注入它:constructor(
private route: ActivatedRoute,
) {}
ngOnInit()
方法来访问这个 ActivatedRoute
并跟踪 name
参数:ngOnInit() {
this.route.queryParams.subscribe(params => {
this.name = params["name"];
});
}
注意:前面的例子使用了一个变量 name
,并根据 name
参数给它赋值。
当用户试图导航到那些不存在的应用部件时,在正常的应用中应该能得到很好的处理。要在应用中添加此功能,需要设置通配符路由。当所请求的 URL 与任何路由器路径都不匹配时,Angular 路由器就会选择这个路由。
要设置通配符路由,请在 routes
定义中添加以下代码。
{ path: "**", component: }
这两个星号 **
告诉 Angular,这个 routes
定义是通配符路由。对于 component 属性,你可以使用应用中的任何组件。常见的选择包括应用专属的 PageNotFoundComponent
,你可以定义它来向用户展示 404 页面,或者跳转到应用的主组件。通配符路由是最后一个路由,因为它匹配所有的 URL。
要显示 404 页面,请设置一个通配符路由,并将 component
属性设置为你要用于 404 页面的组件,如下所示:
const routes: Routes = [
{ path: "first-component", component: FirstComponent },
{ path: "second-component", component: SecondComponent },
{ path: "**", component: PageNotFoundComponent }, // Wildcard route for a 404 page
];
path
为 **
的最后一条路由是通配符路由。如果请求的 URL 与前面列出的路径不匹配,路由器会选择这个路由,并把该用户送到 PageNotFoundComponent
。
要设置重定向,请使用重定向源的 path
、要重定向目标的 component
和一个 pathMatch
值来配置路由,以告诉路由器该如何匹配 URL。
const routes: Routes = [
{ path: "first-component", component: FirstComponent },
{ path: "second-component", component: SecondComponent },
{ path: "", redirectTo: "/first-component", pathMatch: "full" }, // redirect to `first-component`
{ path: "**", component: PageNotFoundComponent }, // Wildcard route for a 404 page
];
在这个例子中,第三个路由是重定向路由,所以路由器会默认跳到 first-component
路由。注意,这个重定向路由位于通配符路由之前。这里的 path: ""
表示使用初始的相对 URL( ""
)。
随着你的应用变得越来越复杂,你可能要创建一些根组件之外的相对路由。这些嵌套路由类型称为子路由。这意味着你要为你的应用添加第二 <router-outlet>
,因为它是 AppComponent
之外的另一个 <router-outlet>
。
在这个例子中,还有两个子组件,child-a
和 child-b
。这里的 FirstComponent
有它自己的 <nav>
和 AppComponent
之外的第二 <router-outlet>
。
<h2>First Component</h2>
<nav>
<ul>
<li><a routerLink="child-a">Child A</a></li>
<li><a routerLink="child-b">Child B</a></li>
</ul>
</nav>
<router-outlet></router-outlet>
子路由和其它路由一样,同时需要 path
和 component
。唯一的区别是你要把子路由放在父路由的 children
数组中。
const routes: Routes = [
{
path: "first-component",
component: FirstComponent, // this is the component with the <router-outlet> in the template
children: [
{
path: "child-a", // child route path
component: ChildAComponent, // child route component that the router renders
},
{
path: "child-b",
component: ChildBComponent, // another child route component that the router renders
},
],
},
];
相对路径允许你定义相对于当前 URL 段的路径。下面的例子展示了到另一个组件 second-component
的相对路由。FirstComponent
和 SecondComponent
在树中处于同一级别,但是,指向 SecondComponent
的链接位于 FirstComponent
中,这意味着路由器必须先上升一个级别,然后进入二级目录才能找到 SecondComponent
。可以用 ../
符号来上升一个级别,而不用写出到 SecondComponent
的完整路径。
<h2>First Component</h2>
<nav>
<ul>
<li><a routerLink="../second-component">Relative Route to second component</a></li>
</ul>
</nav>
<router-outlet></router-outlet>
除了 ../
,还可以使用 ./
或者不带前导斜杠来指定当前级别。
要指定相对路由,请使用 NavigationExtras
中的 relativeTo
属性。在组件类中,从 @angular/router
导入 NavigationExtras
。
然后在导航方法中使用 relativeTo
参数。在链接参数数组(它包含 items
)之后添加一个对象,把该对象的 relativeTo
属性设置为当前的 ActivatedRoute
,也就是 this.route
。
goToItems() {
this.router.navigate(["items"], { relativeTo: this.route });
}
goToItems()
方法会把目标 URI 解释为相对于当前路由的,并导航到 items
路由。
有时,应用中的某个特性需要访问路由的部件,比如查询参数或片段(fragment)。本教程的这个阶段使用了一个“英雄之旅”中的列表视图,你可以在其中点击一个英雄来查看详情。路由器使用 id
来显示正确的英雄的详情。
首先,在要导航的组件中导入以下成员。
import { ActivatedRoute } from "@angular/router";
import { Observable } from "rxjs";
import { switchMap } from "rxjs/operators";
接下来,注入当前路由(ActivatedRoute)服务:
constructor(private route: ActivatedRoute) {}
配置这个类,让你有一个可观察对象 heroes$
、一个用来保存英雄的 id
号的 selectedId
,以及 ngOnInit()
中的英雄们,添加下面的代码来获取所选英雄的 id
。这个代码片段假设你有一个英雄列表、一个英雄服务、一个能获取你的英雄的函数,以及用来渲染你的列表和细节的 HTML,就像在《英雄之旅》例子中一样。
heroes$: Observable;
selectedId: number;
heroes = HEROES;
ngOnInit() {
this.heroes$ = this.route.paramMap.pipe(
switchMap(params => {
this.selectedId = Number(params.get("id"));
return this.service.getHeroes();
})
);
}
接下来,在要导航到的组件中,导入以下成员。
import { Router, ActivatedRoute, ParamMap } from "@angular/router";
import { Observable } from "rxjs";
在组件类的构造函数中注入 ActivatedRoute
和 Router
,这样在这个组件中就可以用它们了:
hero$: Observable;
constructor(
private route: ActivatedRoute,
private router: Router ) {}
ngOnInit() {
const heroId = this.route.snapshot.paramMap.get("id");
this.hero$ = this.service.getHero(heroId);
}
gotoItems(hero: Hero) {
const heroId = hero ? hero.id : null;
// Pass along the hero id if available
// so that the HeroList component can select that item.
this.router.navigate(["/heroes", { id: heroId }]);
}
你可以配置路由定义来实现惰性加载模块,这意味着 Angular 只会在需要时才加载这些模块,而不是在应用启动时就加载全部。 另外,你可以在后台预加载一些应用部件来改善用户体验。
使用路由守卫来防止用户未经授权就导航到应用的某些部分。Angular 中提供了以下路由守卫:
CanActivate
CanActivateChild
CanDeactivate
Resolve
CanLoad
要想使用路由守卫,可以考虑使用无组件路由,因为这对于保护子路由很方便。
为你的守卫创建一项服务:
ng generate guard your-guard
请在守卫类里实现你要用到的守卫。下面的例子使用 CanActivate
来保护该路由。
export class YourGuard implements CanActivate {
canActivate(
next: ActivatedRouteSnapshot,
state: RouterStateSnapshot): boolean {
// your logic goes here
}
}
在路由模块中,在 routes
配置中使用相应的属性。这里的 canActivate
会告诉路由器它要协调到这个特定路由的导航。
{
path: "/your-path",
component: YourComponent,
canActivate: [YourGuard],
}
链接参数数组保存路由导航时所需的成分:
可以把 RouterLink
指令绑定到一个数组,就像这样:
<a [routerLink]="["/heroes"]">Heroes</a>
在指定路由参数时,使用如下的两元素数组:
<a [routerLink]="["/hero", hero.id]">
<span class="badge">{{ hero.id }}</span>{{ hero.name }}
</a>
可以在对象中提供可选的路由参数,比如 { foo: "foo" }
:
<a [routerLink]="["/crisis-center", { foo: "foo" }]">Crisis Center</a>
这三个例子涵盖了你在单级路由的应用中所需的一切。不过,在你添加一个像危机中心一样的子路由时,你可以创建新链接数组。
下面这个最小化 RouterLink
例子是基于危机中心指定的默认子路由构建的。
<a [routerLink]="["/crisis-center"]">Crisis Center</a>
请注意以下事项:
/crisis-center
)。CrisisListComponent
,它的路由路径是"/",但你不用显式的添加它。考虑以下路由器链接,它将从应用的根目录导航到巨龙危机(Dragon Crisis):
<a [routerLink]="["/crisis-center", 1]">Dragon Crisis</a>
/crisis-center
)。id
路由参数。id
添加为该数组中的第二个条目(1)。/crisis-center/1
。你也可以把危机中心的路由单独重新定义为 AppComponent
的模板:
template: `
<h1 class="title">Angular Router</h1>
<nav>
<a [routerLink]="["/crisis-center"]">Crisis Center</a>
<a [routerLink]="["/crisis-center/1", { foo: "foo" }]">Dragon Crisis</a>
<a [routerLink]="["/crisis-center/2"]">Shark Crisis</a>
</nav>
<router-outlet></router-outlet>
`
总之,你可以用一级、两级或多级路由来写应用程序。 链接参数数组提供了用来表示任意深度路由的链接参数数组以及任意合法的路由参数序列、必须的路由器参数以及可选的路由参数对象。
当路由器导航到一个新的组件视图时,它会用该视图的 URL 来更新浏览器的当前地址以及历史。
现代 HTML 5 浏览器支持history.pushState API, 这是一项可以改变浏览器的当前地址和历史,却又不会触发服务端页面请求的技术。 路由器可以合成出一个“自然的”URL,它看起来和那些需要进行页面加载的 URL 没什么区别。
下面是危机中心的 URL 在“HTML 5 pushState”风格下的样子:
localhost:3002/crisis-center/
老旧的浏览器在当前地址的 URL 变化时总会往服务器发送页面请求……唯一的例外规则是:当这些变化位于“#”(被称为“hash”)后面时不会发送。通过把应用内的路由 URL 拼接在 #
之后,路由器可以获得这条“例外规则”带来的优点。下面是到危机中心路由的“hash URL”:
localhost:3002/src/#/crisis-center/
路由器通过两种 LocationStrategy
提供者来支持所有这些风格:
PathLocationStrategy
- 默认的策略,支持“HTML 5 pushState”风格。HashLocationStrategy
- 支持“hash URL”风格。RouterModule.forRoot()
函数把 LocationStrategy
设置成了 PathLocationStrategy
,使其成为了默认策略。 你还可以在启动过程中改写(override)它,来切换到 HashLocationStrategy
风格。
你必须在开发项目的早期就选择一种路由策略,因为一旦该应用进入了生产阶段,你网站的访问者就会使用并依赖应用的这些 URL 引用。
几乎所有的 Angular 项目都会使用默认的 HTML 5 风格。它生成的 URL 更易于被用户理解,它也为将来做服务端渲染预留了空间。
在服务器端渲染指定的页面,是一项可以在该应用首次加载时大幅提升响应速度的技术。那些原本需要十秒甚至更长时间加载的应用,可以预先在服务端渲染好,并在少于一秒的时间内完整渲染在用户的设备上。
只有当应用的 URL 看起来像是标准的 Web URL,中间没有 hash(#)时,这个选项才能生效。
路由器使用浏览器的 history.pushState API 进行导航。借助 pushState
你自定义应用中的 URL 路径 localhost:4200/crisis-center
,应用内的 URL 和服务器的 URL 没有区别。
现代的 HTML5 浏览器都支持 pushState
,这也就是为什么很多人把这种 URL 形式称为 "HTML 5" 风格的 URL。
你必须在应用的 index.html
中添加一个 <base href> 元素才能让 pushState
路由正常工作。 浏览器要用 <base href>
的值为引用 CSS、脚本和图片文件时使用的相对 URL 添加前缀。
请把 <base>
元素添加在 <head>
标签的紧后面。如果应用的根目录是 app
目录,那么就可以像这个应用程序一样,设置 index.html
中的 href
值。代码如下。
<base href="/">
后面的指南中会引用 URL 的不同部分。下图是这些部分所指内容的梗概:
foo://example.com:8042/over/there?name=ferret#nose
_/ ______________/_________/ _________/ __/
| | | | |
scheme authority path query fragment
由于路由器默认使用 “HTML 5 pushState” 风格,所以你必须用一个 <base href>
来配置该策略(Strategy)。
配置该策略的首选方式是往 index.html
的 <head>
中添加一个<base href> element标签。
<base href="/">
如果没有该标记,浏览器就可能无法在“深度链接”进入应用时加载资源(图片,CSS,脚本)。
有些开发人员可能无法添加 <base>
元素,这可能是因为它们没有访问 <head>
或 index.html
的权限。
它们仍然可以使用 HTML 5 格式的 URL,但要采取如下步骤进行补救:
<base href>
的 path
应该用 "/" 结尾,浏览器会忽略 path
中最右边的 "/" 后面的字符。<base href>
包含 query
部分,则只有页内链接的 path
部分为空并且没有 query
时,才会使用这里的 query
。 这意味着 <base href>
中的 query
部分只有在使用 HashLocationStrategy
策略时才有用。<base href>
不会使用。在这种方式下,APP_BASE_HREF
的优先度将会导致所有由 Angular 创建的链接忽略 <base href>
。<base href>
中的片段(#后面的部分)永远不会被使用。对所有 Web 资源使用绝对地址:CSS、图片、脚本、模板 HTML。
可以在根模块的 RouterModule.forRoot()
的第二个参数中传入一个带有 useHash: true
的对象,以回到基于 HashLocationStrategy
的传统方式。
import { NgModule } from "@angular/core";
import { BrowserModule } from "@angular/platform-browser";
import { FormsModule } from "@angular/forms";
import { Routes, RouterModule } from "@angular/router";
import { AppComponent } from "./app.component";
import { PageNotFoundComponent } from "./page-not-found/page-not-found.component";
const routes: Routes = [
];
@NgModule({
imports: [
BrowserModule,
FormsModule,
RouterModule.forRoot(routes, { useHash: true }) // .../#/crisis-center/
],
declarations: [
AppComponent,
PageNotFoundComponent
],
providers: [
],
bootstrap: [ AppComponent ]
})
export class AppModule { }
前提条件对下列概念有基本的理解:Angular动画简介转场与触发器可复用动画路由能让用户在应用中的不同路由之间导航。当用户从一...
持续更新你的Angular项目就像Web及其整个生态系统一样,Angular也在持续改进中。Angular平衡了持续改进与强调稳定性之间的冲突,...
AngularJS ng-init 指令 AngularJS 参考手册AngularJS 实例初始化应用时创建一个变量:div ng-app="" ng-init="myText='Hello...
AngularJS ng-readonly 指令 AngularJS 参考手册AngularJS 实例设置输入框为只读:Readonly: input type="checkbox" ng-model="al...
本节为你介绍Node.jsQueryStrings。稳定性: 3 - 稳定该Node.js模块提供了一些处理query strings的工具,你可以通过以下方式访问...
TypeScript 算术运算符示例假设变量a和b中的值分别为10和5。运算符描述示例+(加法)返回操作数的总和a + b = 15-(减法)返回值...
TypeScript Number方法 toFixed()toFixed()方法格式化一个小数点右侧具有特定位数的数字。语法number.toFixed( [digits] )参数详...
决策结构要求程序员指定由程序进行评估或测试的一个或多个条件,以及在条件被确定为true时要执行的一个或多个语句,以及如果条件...