6273 lines
231 KiB
Markdown
6273 lines
231 KiB
Markdown
# Routing & Navigation
|
||
|
||
# 路由与导航
|
||
|
||
The Angular **`Router`** enables navigation from one [view](guide/glossary#view) to the next
|
||
as users perform application tasks.
|
||
|
||
在用户使用应用程序时，Angular的***路由器***能让用户从一个[视图](guide/glossary#view)导航到另一个视图。
|
||
|
||
This guide covers the router's primary features, illustrating them through the evolution
|
||
of a small application that you can <live-example>run live in the browser</live-example>.
|
||
|
||
本章涵盖了该路由器的主要特性。我们通过一个小型应用的成长演进来讲解它。参见<live-example>在线例子</live-example>。
|
||
|
||
<!-- style for all tables on this page -->
|
||
<style>
|
||
td, th {vertical-align: top}
|
||
</style>
|
||
|
||
|
||
## Overview
|
||
|
||
## 概览
|
||
|
||
The browser is a familiar model of application navigation:
|
||
|
||
浏览器具有我们熟悉的导航模式：
|
||
|
||
* Enter a URL in the address bar and the browser navigates to a corresponding page.
|
||
|
||
在地址栏输入URL，浏览器就会导航到相应的页面。
|
||
|
||
* Click links on the page and the browser navigates to a new page.
|
||
|
||
在页面中点击链接，浏览器就会导航到一个新页面。
|
||
|
||
* Click the browser's back and forward buttons and the browser navigates
|
||
backward and forward through the history of pages you've seen.
|
||
|
||
点击浏览器的前进和后退按钮，浏览器就会在你的浏览历史中向前或向后导航。
|
||
|
||
The Angular `Router` ("the router") borrows from this model.
|
||
It can interpret a browser URL as an instruction to navigate to a client-generated view.
|
||
It can pass optional parameters along to the supporting view component that help it decide what specific content to present.
|
||
You can bind the router to links on a page and it will navigate to
|
||
the appropriate application view when the user clicks a link.
|
||
You can navigate imperatively when the user clicks a button, selects from a drop box,
|
||
or in response to some other stimulus from any source. And the router logs activity
|
||
in the browser's history journal so the back and forward buttons work as well.
|
||
|
||
Angular的`Router`（即“路由器”）借鉴了这个模型。它把浏览器中的URL看做一个操作指南，
|
||
据此导航到一个由客户端生成的视图，并可以把参数传给支撑视图的相应组件，帮它决定具体该展现哪些内容。
|
||
我们可以为页面中的链接绑定一个路由，这样，当用户点击链接时，就会导航到应用中相应的视图。
|
||
当用户点击按钮、从下拉框中选取，或响应来自任何地方的事件时，我们也可以在代码控制下进行导航。
|
||
路由器还在浏览器的历史日志中记录下这些活动，这样浏览器的前进和后退按钮也能照常工作。
|
||
|
||
{@a basics}
|
||
|
||
|
||
## The Basics
|
||
|
||
## 基础知识
|
||
|
||
This guide proceeds in phases, marked by milestones, starting from a simple two-pager
|
||
and building toward a modular, multi-view design with child routes.
|
||
|
||
本章是包括一系列里程碑，从一个单模块、两个页面的简单程序逐步走向带有多个子路由的多视图设计。
|
||
|
||
An introduction to a few core router concepts will help orient you to the details that follow.
|
||
|
||
在接触细节之前，我们先来介绍关于路由的一些核心概念。
|
||
|
||
|
||
{@a basics-base-href}
|
||
|
||
|
||
### *<base href>*
|
||
|
||
Most routing applications should add a `<base>` element to the `index.html` as the first child in the `<head>` tag
|
||
to tell the router how to compose navigation URLs.
|
||
|
||
大多数带路由的应用都要在**`index.html`**的`<head>`标签下先添加一个`<base>`元素，来告诉路由器该如何合成导航用的URL。
|
||
|
||
If the `app` folder is the application root, as it is for the sample application,
|
||
set the `href` value *exactly* as shown here.
|
||
|
||
如果`app`文件夹是该应用的根目录（就像我们的范例应用一样），那就把`href`的值设置为下面这样：
|
||
|
||
|
||
<code-example path="router/src/index.html" linenums="false" title="src/index.html (base-href)" region="base-href">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
{@a basics-router-imports}
|
||
|
||
|
||
### Router imports
|
||
|
||
### 从路由库中导入
|
||
|
||
The Angular Router is an optional service that presents a particular component view for a given URL.
|
||
It is not part of the Angular core. It is in its own library package, `@angular/router`.
|
||
Import what you need from it as you would from any other Angular package.
|
||
|
||
Angular的路由器是一个可选的服务，它用来呈现指定的URL所对应的视图。
|
||
它并不是Angular核心库的一部分，而是在它自己的`@angular/router`包中。
|
||
像其它Angular包一样，我们可以从它导入所需的一切。
|
||
|
||
|
||
<code-example path="router/src/app/app.module.1.ts" linenums="false" title="src/app/app.module.ts (import)" region="import-router">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
You'll learn about more options in the [details below](#browser-url-styles).
|
||
|
||
我们将会在[后面](guide/router#browser-url-styles)详细讲解其它选项。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
{@a basics-config}
|
||
|
||
|
||
### Configuration
|
||
|
||
### 配置
|
||
|
||
A routed Angular application has one singleton instance of the *`Router`* service.
|
||
When the browser's URL changes, that router looks for a corresponding `Route`
|
||
from which it can determine the component to display.
|
||
|
||
每个带路由的Angular应用都有一个*`Router`（路由器）*服务的单例对象。
|
||
当浏览器的URL变化时，路由器会查找对应的`Route`（路由），并据此决定该显示哪个组件。
|
||
|
||
A router has no routes until you configure it.
|
||
The following example creates four route definitions, configures the router via the `RouterModule.forRoot` method,
|
||
and adds the result to the `AppModule`'s `imports` array.
|
||
|
||
路由器需要先配置才会有路由信息。
|
||
下面的例子创建了四个路由定义，并用`RouterModule.forRoot`方法来配置路由器，
|
||
并把它的返回值添加到`AppModule`的`imports`数组中。
|
||
|
||
|
||
<code-example path="router/src/app/app.module.0.ts" linenums="false" title="src/app/app.module.ts (excerpt)">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
{@a example-config}
|
||
|
||
|
||
The `appRoutes` array of *routes* describes how to navigate.
|
||
Pass it to the `RouterModule.forRoot` method in the module `imports` to configure the router.
|
||
|
||
这里的路由树组`appRoutes`描述如何进行导航。
|
||
把它传给`RouterModule.forRoot`方法并传给本模块的`imports`数组就可以配置路由器。
|
||
|
||
Each `Route` maps a URL `path` to a component.
|
||
There are _no leading slashes_ in the _path_.
|
||
The router parses and builds the final URL for you,
|
||
allowing you to use both relative and absolute paths when navigating between application views.
|
||
|
||
每个`Route`都会把一个URL的`path`映射到一个组件。
|
||
注意，`path`不能以*斜杠（`/`）*开头。
|
||
路由器会为解析和构建最终的URL，这样当我们在应用的多个视图之间导航时，可以任意使用相对路径和绝对路径。
|
||
|
||
The `:id` in the second route is a token for a route parameter. In a URL such as `/hero/42`, "42"
|
||
is the value of the `id` parameter. The corresponding `HeroDetailComponent`
|
||
will use that value to find and present the hero whose `id` is 42.
|
||
You'll learn more about route parameters later in this guide.
|
||
|
||
第一个路由中的`:id`是一个路由参数的令牌(Token)。比如`/hero/42`这个URL中，“42”就是`id`参数的值。
|
||
此URL对应的`HeroDetailComponent`组件将据此查找和展现`id`为42的英雄。
|
||
在本章中稍后的部分，我们将会学习关于路由参数的更多知识。
|
||
|
||
|
||
The `data` property in the third route is a place to store arbitrary data associated with
|
||
this specific route. The data property is accessible within each activated route. Use it to store
|
||
items such as page titles, breadcrumb text, and other read-only, _static_ data.
|
||
You'll use the [resolve guard](#resolve-guard) to retrieve _dynamic_ data later in the guide.
|
||
|
||
第三个路由中的`data`属性用来存放于每个具体路由有关的任意信息。该数据可以被任何一个激活路由访问，并能用来保存诸如
|
||
页标题、面包屑以及其它静态只读数据。本章稍后的部分，我们将使用[resolve守卫](guide/router#resolve-guard)来获取动态数据。
|
||
|
||
The **empty path** in the fourth route represents the default path for the application,
|
||
the place to go when the path in the URL is empty, as it typically is at the start.
|
||
This default route redirects to the route for the `/heroes` URL and, therefore, will display the `HeroesListComponent`.
|
||
|
||
第四个路由中的空路径（`''`）表示应用的默认路径，当URL为空时就会访问那里，因此它通常会作为起点。
|
||
这个默认路由会重定向到URL `/heroes`，并显示`HeroesListComponent`。
|
||
|
||
The `**` path in the last route is a **wildcard**. The router will select this route
|
||
if the requested URL doesn't match any paths for routes defined earlier in the configuration.
|
||
This is useful for displaying a "404 - Not Found" page or redirecting to another route.
|
||
|
||
最后一个路由中的`**`路径是一个**通配符**。当所请求的URL不匹配前面定义的路由表中的任何路径时，路由器就会选择此路由。
|
||
这个特性可用于显示“404 - Not Found”页，或自动重定向到其它路由。
|
||
|
||
**The order of the routes in the configuration matters** and this is by design. The router uses a **first-match wins**
|
||
strategy when matching routes, so more specific routes should be placed above less specific routes.
|
||
In the configuration above, routes with a static path are listed first, followed by an empty path route,
|
||
that matches the default route.
|
||
The wildcard route comes last because it matches _every URL_ and should be selected _only_ if no other routes are matched first.
|
||
|
||
**这些路由的定义顺序**是刻意如此设计的。路由器使用**先匹配者优先**的策略来匹配路由，所以，具体路由应该放在通用路由的前面。在上面的配置中，带静态路径的路由被放在了前面，后面是空路径路由，因此它会作为默认路由。而通配符路由被放在最后面，这是因为它能匹配上*每一个URL*，因此应该**只有在**前面找不到其它能匹配的路由时才匹配它。
|
||
|
||
If you need to see what events are happening during the navigation lifecycle, there is the **enableTracing** option as part of the router's default configuration. This outputs each router event that took place during each navigation lifecycle to the browser console. This should only be used for _debugging_ purposes. You set the `enableTracing: true` option in the object passed as the second argument to the `RouterModule.forRoot()` method.
|
||
|
||
{@a basics-router-outlet}
|
||
|
||
|
||
### Router outlet
|
||
|
||
### 路由出口
|
||
|
||
Given this configuration, when the browser URL for this application becomes `/heroes`,
|
||
the router matches that URL to the route path `/heroes` and displays the `HeroListComponent`
|
||
_after_ a `RouterOutlet` that you've placed in the host view's HTML.
|
||
|
||
有了这份配置，当本应用在浏览器中的URL变为`/heroes`时，路由器就会匹配到`path`为`heroes`的`Route`，并在宿主视图中的*`RouterOutlet`*之后显示`HeroListComponent`组件。
|
||
|
||
|
||
<code-example language="html">
|
||
<router-outlet></router-outlet>
|
||
<!-- Routed views go here -->
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
{@a basics-router-links}
|
||
|
||
|
||
### Router links
|
||
|
||
### 路由器链接
|
||
|
||
Now you have routes configured and a place to render them, but
|
||
how do you navigate? The URL could arrive directly from the browser address bar.
|
||
But most of the time you navigate as a result of some user action such as the click of
|
||
an anchor tag.
|
||
|
||
现在，我们已经有了配置好的一些路由，还找到了渲染它们的地方，但又该如何导航到它呢？固然，从浏览器的地址栏直接输入URL也能做到，但是大多数情况下，导航是某些用户操作的结果，比如点击一个A标签。
|
||
|
||
Consider the following template:
|
||
|
||
考虑下列模板：
|
||
|
||
|
||
<code-example path="router/src/app/app.component.1.ts" linenums="false" title="src/app/app.component.ts (template)" region="template">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
The `RouterLink` directives on the anchor tags give the router control over those elements.
|
||
The navigation paths are fixed, so you can assign a string to the `routerLink` (a "one-time" binding).
|
||
|
||
`a`标签上的`RouterLink`指令让路由器得以控制这个`a`元素。
|
||
这里的导航路径是固定的，因此可以把一个字符串赋给`routerLink`（“一次性”绑定）。
|
||
|
||
Had the navigation path been more dynamic, you could have bound to a template expression that
|
||
returned an array of route link parameters (the _link parameters array_).
|
||
The router resolves that array into a complete URL.
|
||
|
||
如果需要更加动态的导航路径，那就把它绑定到一个返回*链接参数数组*的模板表达式。
|
||
路由器会把这个数组解析成完整的URL。
|
||
|
||
The **`RouterLinkActive`** directive on each anchor tag helps visually distinguish the anchor for the currently selected "active" route.
|
||
The router adds the `active` CSS class to the element when the associated *RouterLink* becomes active.
|
||
You can add this directive to the anchor or to its parent element.
|
||
|
||
每个`a`标签上的**`RouterLinkActive`**指令可以帮用户在外观上区分出当前选中的“活动”路由。
|
||
当与它关联的*RouterLink*被激活时，路由器会把CSS类`active`添加到这个元素上。
|
||
我们可以把该指令添加到`a`元素或它的父元素上。
|
||
|
||
|
||
{@a basics-router-state}
|
||
|
||
|
||
### Router state
|
||
|
||
### 路由器状态
|
||
|
||
After the end of each successful navigation lifecycle, the router builds a tree of `ActivatedRoute` objects
|
||
that make up the current state of the router. You can access the current `RouterState` from anywhere in the
|
||
application using the `Router` service and the `routerState` property.
|
||
|
||
在导航时的每个生命周期成功完成时，路由器会构建出一个`ActivatedRoute`组成的树，它表示路由器的当前状态。
|
||
我们可以在应用中的任何地方用`Router`服务及其`routerState`属性来访问当前的`RouterState`值。
|
||
|
||
Each `ActivatedRoute` in the `RouterState` provides methods to traverse up and down the route tree
|
||
to get information from parent, child and sibling routes.
|
||
|
||
路由器状态为我们提供了从任意激活路由开始向上或向下遍历路由树的一种方式，以获得关于父、子、兄弟路由的信息。
|
||
|
||
### Router events
|
||
|
||
During each navigation, the `Router` emits navigation events through the `Router.events` property. These events range from when the navigation starts and ends to many points in between. The full list of navigation events is displayed in the table below.
|
||
|
||
<table>
|
||
<tr>
|
||
<th>
|
||
Router Event
|
||
</th>
|
||
|
||
<th>
|
||
Description
|
||
</th>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
<code>NavigationStart</code>
|
||
</td>
|
||
<td>
|
||
|
||
An [event](api/router/NavigationStart) triggered when navigation starts.
|
||
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
<code>RoutesRecognized</code>
|
||
</td>
|
||
<td>
|
||
|
||
An [event](api/router/RoutesRecognized) triggered when the Router parses the URL and the routes are recognized.
|
||
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
<code>RouteConfigLoadStart</code>
|
||
</td>
|
||
<td>
|
||
|
||
An [event](api/router/RouteConfigLoadStart) triggered before the `Router`
|
||
[lazy loads](#asynchronous-routing) a route configuration.
|
||
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
<code>RouteConfigLoadEnd</code>
|
||
</td>
|
||
<td>
|
||
|
||
An [event](api/router/RouteConfigLoadEnd) triggered after a route has been lazy loaded.
|
||
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
<code>NavigationEnd</code>
|
||
</td>
|
||
<td>
|
||
|
||
An [event](api/router/NavigationEnd) triggered when navigation ends successfully.
|
||
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
<code>NavigationCancel</code>
|
||
</td>
|
||
<td>
|
||
|
||
An [event](api/router/NavigationCancel) triggered when navigation is canceled.
|
||
This is due to a [Route Guard](#guards) returning false during navigation.
|
||
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
<code>NavigationError</code>
|
||
</td>
|
||
<td>
|
||
|
||
An [event](api/router/NavigationError) triggered when navigation fails due to an unexpected error.
|
||
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
|
||
These events are logged to the console when the `enableTracing` option is enabled also. Since the events are provided as an `Observable`, you can `filter()` for events of interest and `subscribe()` to them to make decisions based on the sequence of events in the navigation process.
|
||
|
||
|
||
{@a basics-summary}
|
||
|
||
|
||
### Summary
|
||
|
||
### 总结一下
|
||
|
||
The application has a configured router.
|
||
The shell component has a `RouterOutlet` where it can display views produced by the router.
|
||
It has `RouterLink`s that users can click to navigate via the router.
|
||
|
||
该应用有一个配置过的路由器。
|
||
外壳组件中有一个`RouterOutlet`，它能显示路由器所生成的视图。
|
||
它还有一些`RouterLink`，用户可以点击它们，来通过路由器进行导航。
|
||
|
||
Here are the key `Router` terms and their meanings:
|
||
|
||
下面是一些*路由器*中的关键词汇及其含义：
|
||
|
||
<table>
|
||
|
||
<tr>
|
||
|
||
<th>
|
||
|
||
<p>
|
||
Router Part
|
||
</p>
|
||
|
||
<p>
|
||
路由器部件
|
||
</p>
|
||
|
||
</th>
|
||
|
||
<th>
|
||
|
||
<p>
|
||
Meaning
|
||
</p>
|
||
|
||
<p>
|
||
含义
|
||
</p>
|
||
|
||
</th>
|
||
|
||
</tr>
|
||
|
||
<tr>
|
||
|
||
<td>
|
||
|
||
<p>
|
||
<code>Router</code>
|
||
</p>
|
||
|
||
<p>
|
||
<code>Router</code>（路由器）
|
||
</p>
|
||
|
||
</td>
|
||
|
||
<td>
|
||
|
||
<p>
|
||
Displays the application component for the active URL.
|
||
Manages navigation from one component to the next.
|
||
</p>
|
||
|
||
<p>
|
||
为激活的URL显示应用组件。管理从一个组件到另一个组件的导航
|
||
</p>
|
||
|
||
</td>
|
||
|
||
</tr>
|
||
|
||
<tr>
|
||
|
||
<td>
|
||
|
||
<p>
|
||
<code>RouterModule</code>
|
||
</p>
|
||
|
||
<p>
|
||
<code>RouterModule</code>（路由器模块）
|
||
</p>
|
||
|
||
</td>
|
||
|
||
<td>
|
||
|
||
<p>
|
||
A separate NgModule that provides the necessary service providers
|
||
and directives for navigating through application views.
|
||
</p>
|
||
|
||
<p>
|
||
一个独立的Angular模块，用于提供所需的服务提供商，以及用来在应用视图之间进行导航的指令。
|
||
</p>
|
||
</td>
|
||
|
||
</tr>
|
||
|
||
<tr>
|
||
|
||
<td>
|
||
|
||
<p>
|
||
<code>Routes</code>
|
||
</p>
|
||
|
||
<p>
|
||
<code>Routes</code>（路由数组）
|
||
</p>
|
||
|
||
</td>
|
||
|
||
<td>
|
||
|
||
<p>
|
||
Defines an array of Routes, each mapping a URL path to a component.
|
||
</p>
|
||
|
||
<p>
|
||
定义了一个路由数组，每一个都会把一个URL路径映射到一个组件。
|
||
</p>
|
||
|
||
</td>
|
||
|
||
</tr>
|
||
|
||
<tr>
|
||
|
||
<td>
|
||
|
||
<p>
|
||
<code>Route</code>
|
||
</p>
|
||
|
||
<p>
|
||
<code>Route</code>（路由）
|
||
</p>
|
||
|
||
</td>
|
||
|
||
<td>
|
||
|
||
<p>
|
||
Defines how the router should navigate to a component based on a URL pattern.
|
||
Most routes consist of a path and a component type.
|
||
</p>
|
||
|
||
<p>
|
||
定义路由器该如何根据URL模式（pattern）来导航到组件。大多数路由都由路径和组件类构成。
|
||
</p>
|
||
|
||
</td>
|
||
|
||
</tr>
|
||
|
||
<tr>
|
||
|
||
<td>
|
||
|
||
<p>
|
||
<code>RouterOutlet</code>
|
||
</p>
|
||
|
||
<p>
|
||
<code>RouterOutlet</code>（路由出口）
|
||
</p>
|
||
|
||
</td>
|
||
|
||
<td>
|
||
|
||
<p>
|
||
The directive (<code><router-outlet></code>) that marks where the router displays a view.
|
||
</p>
|
||
|
||
<p>
|
||
该指令（<code><router-outlet></code>）用来标记出路由器该在哪里显示视图。
|
||
</p>
|
||
|
||
</td>
|
||
|
||
</tr>
|
||
|
||
<tr>
|
||
|
||
<td>
|
||
|
||
<p>
|
||
<code>RouterLink</code>
|
||
</p>
|
||
|
||
<p>
|
||
<code>RouterLink</code>（路由链接）
|
||
</p>
|
||
|
||
</td>
|
||
|
||
<td>
|
||
|
||
<p>
|
||
The directive for binding a clickable HTML element to
|
||
a route. Clicking an element with a <code>routerLink</code> directive
|
||
that is bound to a <i>link parameters array</i> triggers a navigation.
|
||
</p>
|
||
|
||
<p>
|
||
该指令用来把一个可点击的HTML元素绑定到路由。
|
||
点击带有绑定到<i>字符串</i>或<i>链接参数数组</i>的<code>routerLink</code>指令的元素就会触发一次导航。
|
||
</p>
|
||
|
||
</td>
|
||
|
||
</tr>
|
||
|
||
<tr>
|
||
|
||
<td>
|
||
|
||
<p>
|
||
<code>RouterLinkActive</code>
|
||
</p>
|
||
|
||
<p>
|
||
<code>RouterLinkActive</code>（活动路由链接）
|
||
</p>
|
||
|
||
</td>
|
||
|
||
<td>
|
||
|
||
<p>
|
||
The directive for adding/removing classes from an HTML element when an associated
|
||
<code>routerLink</code> contained on or inside the element becomes active/inactive.
|
||
</p>
|
||
|
||
<p>
|
||
当HTML元素上或元素内的<code>routerLink</code>变为激活或非激活状态时，该指令为这个HTML元素添加或移除CSS类。
|
||
</p>
|
||
|
||
</td>
|
||
|
||
</tr>
|
||
|
||
<tr>
|
||
|
||
<td>
|
||
|
||
<p>
|
||
<code>ActivatedRoute</code>
|
||
</p>
|
||
|
||
<p>
|
||
<code>ActivatedRoute</code>（激活的路由）
|
||
</p>
|
||
|
||
</td>
|
||
|
||
<td>
|
||
|
||
<p>
|
||
A service that is provided to each route component that contains route specific
|
||
information such as route parameters, static data, resolve data, global query params, and the global fragment.
|
||
</p>
|
||
|
||
<p>
|
||
为每个路由组件提供提供的一个服务，它包含特定于路由的信息，比如路由参数、静态数据、解析数据、全局查询参数和全局碎片（fragment）。
|
||
</p>
|
||
|
||
</td>
|
||
|
||
</tr>
|
||
|
||
<tr>
|
||
|
||
<td>
|
||
|
||
<p>
|
||
<code>RouterState</code>
|
||
</p>
|
||
|
||
<p>
|
||
<code>RouterState</code>（路由器状态）
|
||
</p>
|
||
|
||
</td>
|
||
|
||
<td>
|
||
|
||
<p>
|
||
The current state of the router including a tree of the currently activated
|
||
routes together with convenience methods for traversing the route tree.
|
||
</p>
|
||
|
||
<p>
|
||
路由器的当前状态包含了一棵由程序中激活的路由构成的树。它包含一些用于遍历路由树的快捷方法。
|
||
</p>
|
||
|
||
</td>
|
||
|
||
</tr>
|
||
|
||
<tr>
|
||
|
||
<td>
|
||
|
||
<p>
|
||
<b><i>Link parameters array</i></b>
|
||
</p>
|
||
|
||
<p>
|
||
<i>链接参数数组</i>
|
||
</p>
|
||
|
||
</td>
|
||
|
||
<td>
|
||
|
||
<p>
|
||
An array that the router interprets as a routing instruction.
|
||
You can bind that array toa <code>RouterLink</code> or pass the array as an argument to
|
||
the <code>Router.navigate</code> method.
|
||
</p>
|
||
|
||
<p>
|
||
这个数组会被路由器解释成一个路由操作指南。我们可以把一个<code>RouterLink</code>绑定到该数组，或者把它作为参数传给<code>Router.navigate</code>方法。
|
||
</p>
|
||
|
||
</td>
|
||
|
||
</tr>
|
||
|
||
<tr>
|
||
|
||
<td>
|
||
|
||
<p>
|
||
<b><i>Routing component</i></b>
|
||
</p>
|
||
|
||
<p>
|
||
<b><i>路由组件</i></b>
|
||
</p>
|
||
|
||
</td>
|
||
|
||
<td>
|
||
<p> An Angular component with a <code>RouterOutlet</code> that displays views based on router navigations.
|
||
</p>
|
||
|
||
<p>
|
||
一个带有<code>RouterOutlet</code>的Angular组件，它根据路由器的导航来显示相应的视图。
|
||
</p>
|
||
</td>
|
||
|
||
</tr>
|
||
|
||
</table>
|
||
|
||
|
||
|
||
|
||
{@a sample-app-intro}
|
||
|
||
|
||
## The sample application
|
||
|
||
## 范例应用
|
||
|
||
This guide describes development of a multi-page routed sample application.
|
||
Along the way, it highlights design decisions and describes key features of the router such as:
|
||
|
||
本章要讲的是如何开发一个带路由的多页面应用。
|
||
接下来，我们会重点讲它的设计决策，并描述路由的关键特性，比如：
|
||
|
||
* Organizing the application features into modules.
|
||
|
||
把应用的各个特性组织成模块。
|
||
|
||
* Navigating to a component (*Heroes* link to "Heroes List").
|
||
|
||
导航到组件（*Heroes*链接到“英雄列表”组件）。
|
||
|
||
* Including a route parameter (passing the Hero `id` while routing to the "Hero Detail").
|
||
|
||
包含一个路由参数（当路由到“英雄详情”时，把该英雄的`id`传进去）。
|
||
|
||
* Child routes (the *Crisis Center* has its own routes).
|
||
|
||
子路由（*危机中心*特性有一组自己的路由）。
|
||
|
||
* The `CanActivate` guard (checking route access).
|
||
|
||
`CanActivate`守卫（检查路由的访问权限）。
|
||
|
||
* The `CanActivateChild` guard (checking child route access).
|
||
|
||
`CanActivateChild`守卫（检查子路由的访问权限）。
|
||
|
||
* The `CanDeactivate` guard (ask permission to discard unsaved changes).
|
||
|
||
`CanDeactivate`守卫（询问是否丢弃未保存的更改）。
|
||
|
||
* The `Resolve` guard (pre-fetching route data).
|
||
|
||
`Resolve`守卫（预先获取路由数据）。
|
||
|
||
* Lazy loading feature modules.
|
||
|
||
惰性加载特性模块。
|
||
|
||
* The `CanLoad` guard (check before loading feature module assets).
|
||
|
||
`CanLoad`守卫（在加载特性模块之前进行检查）。
|
||
|
||
|
||
The guide proceeds as a sequence of milestones as if you were building the app step-by-step.
|
||
But, it is not a tutorial and it glosses over details of Angular application construction
|
||
that are more thoroughly covered elsewhere in the documentation.
|
||
|
||
如果打算一步步构建出本应用，本章就会经过一系列里程碑。
|
||
但是，本章并不是一个教程，它隐藏了构造Angular应用的细节，那些细节会在本文档的其它地方展开。
|
||
|
||
The full source for the final version of the app can be seen and downloaded from the <live-example></live-example>.
|
||
|
||
本应用的最终版源码可以在<live-example></live-example>中查看和下载。
|
||
|
||
|
||
### The sample application in action
|
||
|
||
### 范例程序的动图
|
||
|
||
Imagine an application that helps the _Hero Employment Agency_ run its business.
|
||
Heroes need work and the agency finds crises for them to solve.
|
||
|
||
假设本程序会用来帮助“英雄管理局”运行他们的业务。
|
||
英雄们需要找工作，而“英雄管理局”为它们寻找待解决的危机。
|
||
|
||
The application has three main feature areas:
|
||
|
||
本应用具有三个主要的特性区：
|
||
|
||
1. A *Crisis Center* for maintaining the list of crises for assignment to heroes.
|
||
|
||
*危机中心*用于维护要指派给英雄的危机列表。
|
||
|
||
1. A *Heroes* area for maintaining the list of heroes employed by the agency.
|
||
|
||
*英雄*区用于维护管理局雇佣的英雄列表。
|
||
|
||
1. An *Admin* area to manage the list of crises and heroes.
|
||
|
||
*管理*区会管理危机和英雄的列表。
|
||
|
||
Try it by clicking on this <live-example title="Hero Employment Agency Live Example">live example link</live-example>.
|
||
|
||
点击<live-example title="Hero Employment Agency Live Example"></live-example>试用一下。
|
||
|
||
Once the app warms up, you'll see a row of navigation buttons
|
||
and the *Heroes* view with its list of heroes.
|
||
|
||
等应用热身完毕，我们就会看到一排导航按钮，以及一个*英雄列表*视图。
|
||
|
||
|
||
<figure>
|
||
<img src='generated/images/guide/router/hero-list.png' alt="Hero List">
|
||
</figure>
|
||
|
||
|
||
|
||
Select one hero and the app takes you to a hero editing screen.
|
||
|
||
选择其中之一，该应用就会把我们带到此英雄的编辑页面。
|
||
|
||
|
||
<figure>
|
||
<img src='generated/images/guide/router/hero-detail.png' alt="Crisis Center Detail">
|
||
</figure>
|
||
|
||
|
||
|
||
Alter the name.
|
||
Click the "Back" button and the app returns to the heroes list which displays the changed hero name.
|
||
Notice that the name change took effect immediately.
|
||
|
||
修改完名字，再点击“后退”按钮，我们又回到了英雄列表页，其中显示的英雄名已经变了。注意，对名字的修改会立即生效。
|
||
|
||
Had you clicked the browser's back button instead of the "Back" button,
|
||
the app would have returned you to the heroes list as well.
|
||
Angular app navigation updates the browser history as normal web navigation does.
|
||
|
||
另外我们也可以点击浏览器本身的后退按钮，这样也同样会回到英雄列表页。
|
||
在Angular应用中导航也会和标准的Web导航一样更新浏览器中的历史。
|
||
|
||
Now click the *Crisis Center* link for a list of ongoing crises.
|
||
|
||
现在，点击*危机中心*链接，前往*危机*列表页。
|
||
|
||
|
||
<figure>
|
||
<img src='generated/images/guide/router/crisis-center-list.png' alt="Crisis Center List">
|
||
</figure>
|
||
|
||
|
||
|
||
Select a crisis and the application takes you to a crisis editing screen.
|
||
The _Crisis Detail_ appears in a child view on the same page, beneath the list.
|
||
|
||
选择其中之一，该应用就会把我们带到此危机的编辑页面。
|
||
*危机详情*出现在了当前页的子视图区，也就是在列表的紧下方。
|
||
|
||
Alter the name of a crisis.
|
||
Notice that the corresponding name in the crisis list does _not_ change.
|
||
|
||
修改危机的名称。
|
||
注意，危机列表中的相应名称**并没有**修改。
|
||
|
||
|
||
<figure>
|
||
<img src='generated/images/guide/router/crisis-center-detail.png' alt="Crisis Center Detail">
|
||
</figure>
|
||
|
||
|
||
|
||
Unlike *Hero Detail*, which updates as you type,
|
||
*Crisis Detail* changes are temporary until you either save or discard them by pressing the "Save" or "Cancel" buttons.
|
||
Both buttons navigate back to the *Crisis Center* and its list of crises.
|
||
|
||
这和*英雄详情*页略有不同。*英雄详情*会立即保存我们所做的更改。
|
||
而*危机详情*页中，我们的更改都是临时的 —— 除非按“保存”按钮保存它们，或者按“取消”按钮放弃它们。
|
||
这两个按钮都会导航回*危机中心*，显示危机列表。
|
||
|
||
***Do not click either button yet***.
|
||
Click the browser back button or the "Heroes" link instead.
|
||
|
||
***先不要点击这些按钮***。
|
||
而是点击浏览器的后退按钮，或者点击“Heroes”链接。
|
||
|
||
Up pops a dialog box.
|
||
|
||
我们会看到弹出了一个对话框。
|
||
|
||
|
||
<figure>
|
||
<img src='generated/images/guide/router/confirm-dialog.png' alt="Confirm Dialog">
|
||
</figure>
|
||
|
||
|
||
|
||
You can say "OK" and lose your changes or click "Cancel" and continue editing.
|
||
|
||
我们可以回答“确定”以放弃这些更改，或者回答“取消”来继续编辑。
|
||
|
||
Behind this behavior is the router's `CanDeactivate` guard.
|
||
The guard gives you a chance to clean-up or ask the user's permission before navigating away from the current view.
|
||
|
||
这种行为的幕后是路由器的`CanDeactivate`守卫。
|
||
该守卫让我们有机会进行清理工作或在离开当前视图之前请求用户的许可。
|
||
|
||
The `Admin` and `Login` buttons illustrate other router capabilities to be covered later in the guide.
|
||
This short introduction will do for now.
|
||
|
||
`Admin`和`Login`按钮用于演示路由器的其它能力，本章稍后的部分会讲解它们。我们现在先不管它。
|
||
|
||
Proceed to the first application milestone.
|
||
|
||
我们这就开始本应用的第一个里程碑。
|
||
|
||
{@a getting-started}
|
||
|
||
## Milestone 1: Getting started with the router
|
||
|
||
## 里程碑1：从路由器开始
|
||
|
||
Begin with a simple version of the app that navigates between two empty views.
|
||
|
||
开始本应用的一个简版，它在两个空路由之间导航。
|
||
|
||
|
||
<figure>
|
||
<img src='generated/images/guide/router/router-1-anim.gif' alt="App in action">
|
||
</figure>
|
||
|
||
|
||
|
||
{@a base-href}
|
||
|
||
|
||
### Set the *<base href>*
|
||
|
||
### 设置*<base href>*
|
||
|
||
The router uses the browser's
|
||
<a href="https://developer.mozilla.org/en-US/docs/Web/API/History_API#Adding_and_modifying_history_entries" title="HTML5 browser history push-state">history.pushState</a>
|
||
for navigation. Thanks to `pushState`, you can make in-app URL paths look the way you want them to
|
||
look, e.g. `localhost:3000/crisis-center`. The in-app URLs can be indistinguishable from server URLs.
|
||
|
||
路由器使用浏览器的<a href="https://developer.mozilla.org/en-US/docs/Web/API/History_API#Adding_and_modifying_history_entries" target="_blank" title="HTML5 browser history push-state">history.pushState</a>进行导航。
|
||
感谢`pushState`！有了它，我们就能按所期望的样子来显示应用内部的URL路径，比如：`localhost:3000/crisis-center`。虽然我们使用的全部是客户端合成的视图，但应用内部的这些URL看起来和来自服务器的没有什么不同。
|
||
|
||
Modern HTML5 browsers were the first to support `pushState` which is why many people refer to these URLs as
|
||
"HTML5 style" URLs.
|
||
|
||
现代HTML 5浏览器是最早支持`pushState`的，这也就是很多人喜欢把这种URL称作“HTML 5风格的”URL的原因。
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
HTML5 style navigation is the router default.
|
||
In the [LocationStrategy and browser URL styles](#browser-url-styles) Appendix,
|
||
learn why HTML5 style is preferred, how to adjust its behavior, and how to switch to the
|
||
older hash (#) style, if necessary.
|
||
|
||
HTML 5风格的导航是路由器的默认值。请到下面的附录[浏览器URL风格](guide/router#browser-url-styles)中学习为什么首选“HTML 5”风格、如何调整它的行为，以及如何在必要时切换回老式的hash（#）风格。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
You must **add a
|
||
<a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/base" title="base href"><base href> element</a>**
|
||
to the app's `index.html` for `pushState` routing to work.
|
||
The browser uses the `<base href>` value to prefix *relative* URLs when referencing
|
||
CSS files, scripts, and images.
|
||
|
||
我们必须往本应用的`index.html`中**添加一个<a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/base" target="_blank" title="base href"><base href> 元素</a>**，这样`pushState`才能正常工作。
|
||
当引用CSS文件、脚本和图片时，浏览器会用`<base href>`的值作为*相对*URL的前缀。
|
||
|
||
Add the `<base>` element just after the `<head>` tag.
|
||
If the `app` folder is the application root, as it is for this application,
|
||
set the `href` value in **`index.html`** *exactly* as shown here.
|
||
|
||
把`<base>`元素添加到`<head>`元素中。
|
||
如果`app`目录是应用的根目录，对于本应用，可以像这样设置**`index.html`**中的`href`值：
|
||
|
||
|
||
<code-example path="router/src/index.html" linenums="false" title="src/index.html (base-href)" region="base-href">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
<div class="callout is-important">
|
||
|
||
|
||
|
||
<header>
|
||
Live example note
|
||
</header>
|
||
|
||
|
||
|
||
A live coding environment like Plunker sets the application base address dynamically so you can't specify a fixed address.
|
||
That's why the example code replaces the `<base href...>` with a script that writes the `<base>` tag on the fly.
|
||
|
||
像Plunker这样的在线编程环境会动态设置应用的基地址（base href），因此我们没办法指定固定的地址。
|
||
这就是为什么我们要用一个脚本动态写入`<base>`标签，而不是直接写`<base href...>`。
|
||
|
||
|
||
<code-example language="html">
|
||
<script>document.write('<base href="' + document.location + '" />');</script>
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
You only need this trick for the live example, not production code.
|
||
|
||
我们只应该在在线例子这种情况下使用这种小花招，不要把它用到产品的正式代码中。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
{@a import}
|
||
|
||
|
||
### Importing from the router library
|
||
|
||
### 从路由库中导入
|
||
|
||
Begin by importing some symbols from the router library.
|
||
The Router is in its own `@angular/router` package.
|
||
It's not part of the Angular core. The router is an optional service because not all applications
|
||
need routing and, depending on your requirements, you may need a different routing library.
|
||
|
||
先从路由库导入一些符号。
|
||
路由器在它自己的`@angular/router`包中。
|
||
它不是Angular内核的一部分。该路由器是可选的服务，这是因为并不是所有应用都需要路由，并且，如果需要，你还可能需要另外的路由库。
|
||
|
||
You teach the router how to navigate by configuring it with routes.
|
||
|
||
通过一些路由来配置路由器，我们可以教它如何进行导航。
|
||
|
||
|
||
{@a route-config}
|
||
|
||
|
||
#### Define routes
|
||
|
||
#### 定义路由
|
||
|
||
A router must be configured with a list of route definitions.
|
||
|
||
路由器必须用“路由定义”的列表进行配置。
|
||
|
||
The first configuration defines an array of two routes with simple paths leading to the
|
||
`CrisisListComponent` and `HeroListComponent`.
|
||
|
||
我们的第一个配置中定义了由两个路由构成的数组，它们分别通过路径(path)导航到了`CrisisListComponent`和`HeroListComponent`组件。
|
||
|
||
Each definition translates to a [Route](api/router/Route) object which has two things: a
|
||
`path`, the URL path segment for this route; and a
|
||
`component`, the component associated with this route.
|
||
|
||
每个定义都被翻译成了一个[Route](api/router/Route)对象。该对象有一个`path`字段，表示该路由中的URL路径部分，和一个`component`字段，表示与该路由相关联的组件。
|
||
|
||
The router draws upon its registry of definitions when the browser URL changes
|
||
or when application code tells the router to navigate along a route path.
|
||
|
||
当浏览器的URL变化时或在代码中告诉路由器导航到一个路径时，路由器就会翻出它用来保存这些路由定义的注册表。
|
||
|
||
In simpler terms, you might say this of the first route:
|
||
|
||
直白的说，我们可以这样解释第一个路由：
|
||
|
||
* When the browser's location URL changes to match the path segment `/crisis-center`, then
|
||
the router activates an instance of the `CrisisListComponent` and displays its view.
|
||
|
||
当浏览器地址栏的URL变化时，如果它匹配上了路径部分`/crisis-center`，路由器就会激活一个`CrisisListComponent`的实例，并显示它的视图。
|
||
|
||
* When the application requests navigation to the path `/crisis-center`, the router
|
||
activates an instance of `CrisisListComponent`, displays its view, and updates the
|
||
browser's address location and history with the URL for that path.
|
||
|
||
**当应用程序请求导航到路径`/crisis-center`时，路由器激活一个`CrisisListComponent`的实例，显示它的视图，并将该路径更新到浏览器地址栏和历史。**
|
||
|
||
|
||
Here is the first configuration. Pass the array of routes, `appRoutes`, to the `RouterModule.forRoot` method.
|
||
It returns a module, containing the configured `Router` service provider, plus other providers that the routing library requires.
|
||
Once the application is bootstrapped, the `Router` performs the initial navigation based on the current browser URL.
|
||
|
||
下面是第一个配置。我们将路由数组传递到`RouterModule.forRoot`方法，该方法返回一个包含已配置的`Router`服务提供商模块和一些其它路由包需要的服务提供商。应用启动时，`Router`将在当前浏览器URL的基础上进行初始导航。
|
||
|
||
|
||
<code-example path="router/src/app/app.module.1.ts" linenums="false" title="src/app/app.module.ts (first-config)" region="first-config">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
Adding the configured `RouterModule` to the `AppModule` is sufficient for simple route configurations.
|
||
As the application grows, you'll want to refactor the routing configuration into a separate file
|
||
and create a **[Routing Module](#routing-module)**, a special type of `Service Module` dedicated to the purpose
|
||
of routing in feature modules.
|
||
|
||
作为简单的路由配置，将添加配置好的`RouterModule`到`AppModule`中就足够了。
|
||
随着应用的成长，我们将需要将路由配置重构到单独的文件，并创建**[路由模块](guide/router#routing-module)** - 一种特别的、专门为特性模块的路由器服务的**服务模块**。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
Providing the `RouterModule` in the `AppModule` makes the Router available everywhere in the application.
|
||
|
||
在`AppModule`中提供`RouterModule`，让该路由器在应用的任何地方都能被使用。
|
||
|
||
|
||
{@a shell}
|
||
|
||
|
||
### The *AppComponent* shell
|
||
|
||
### *AppComponent*外壳组件
|
||
|
||
The root `AppComponent` is the application shell. It has a title, a navigation bar with two links,
|
||
and a *router outlet* where the router swaps views on and off the page. Here's what you get:
|
||
|
||
根组件`AppComponent`是本应用的壳。它在顶部有一个标题、一个带两个链接的导航条，在底部有一个*路由器出口*，路由器会在它所指定的位置上把视图切入或调出页面。就像下图中所标出的：
|
||
|
||
|
||
<figure>
|
||
<img src='generated/images/guide/router/shell-and-outlet.png' alt="Shell">
|
||
</figure>
|
||
|
||
|
||
|
||
{@a shell-template}
|
||
|
||
|
||
The corresponding component template looks like this:
|
||
|
||
该组件所对应的模板是这样的：
|
||
|
||
|
||
<code-example path="router/src/app/app.component.1.ts" linenums="false" title="src/app/app.component.ts (template)" region="template">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
{@a router-outlet}
|
||
|
||
|
||
### *RouterOutlet*
|
||
|
||
The `RouterOutlet` is a directive from the router library that marks
|
||
the spot in the template where the router should display the views for that outlet.
|
||
|
||
`RouterOutlet`是一个来自路由库的组件。
|
||
路由器会在`<router-outlet>`标签中显示视图。
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
The router adds the `<router-outlet>` element to the DOM
|
||
and subsequently inserts the navigated view element
|
||
immediately _after_ the `<router-outlet>`.
|
||
|
||
一个模板中只能有一个***未命名的***`<router-outlet>`。
|
||
但路由器可以支持多个*命名的*出口（outlet），将来我们会涉及到这部分特性。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
{@a router-link}
|
||
|
||
|
||
### *RouterLink* binding
|
||
|
||
### `routerLink` 绑定
|
||
|
||
Above the outlet, within the anchor tags, you see
|
||
[attribute bindings](guide/template-syntax#attribute-binding) to
|
||
the `RouterLink` directive that look like `routerLink="..."`.
|
||
|
||
在出口上方的A标签中，有一个绑定`RouterLink`指令的[属性绑定](guide/template-syntax#property-binding)，就像这样：`routerLink="..."`。我们从路由库中导入了`RouterLink`。
|
||
|
||
The links in this example each have a string path, the path of a route that
|
||
you configured earlier. There are no route parameters yet.
|
||
|
||
例子中的每个链接都有一个字符串型的路径，也就是我们以前配置过的路由路径，但还没有指定路由参数。
|
||
|
||
You can also add more contextual information to the `RouterLink` by providing query string parameters
|
||
or a URL fragment for jumping to different areas on the page. Query string parameters
|
||
are provided through the `[queryParams]` binding which takes an object (e.g. `{ name: 'value' }`), while the URL fragment
|
||
takes a single value bound to the `[fragment]` input binding.
|
||
|
||
我们还可以通过提供查询字符串参数为`RouterLink`提供更多情境信息，或提供一个URL片段（Fragment或hash）来跳转到本页面中的其它区域。
|
||
查询字符串可以由`[queryParams]`绑定来提供，它需要一个对象型参数（如`{ name: 'value' }`），而URL片段需要一个绑定到`[fragment]`的单一值。
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
Learn about the how you can also use the _link parameters array_ in the [appendix below](#link-parameters-array).
|
||
|
||
还可以到[后面的附录](guide/router#link-parameters-array)中学习如何使用**链接参数数组**。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
{@a router-link-active}
|
||
|
||
|
||
### *RouterLinkActive* binding
|
||
|
||
### `routerLinkActive`绑定
|
||
|
||
On each anchor tag, you also see [property bindings](guide/template-syntax#property-binding) to
|
||
the `RouterLinkActive` directive that look like `routerLinkActive="..."`.
|
||
|
||
每个A标签还有一个到`RouterLinkActive`指令的[属性绑定](guide/template-syntax#property-binding)，就像`routerLinkActive="..."`。
|
||
|
||
The template expression to the right of the equals (=) contains a space-delimited string of CSS classes
|
||
that the Router will add when this link is active (and remove when the link is inactive).
|
||
You can also set the `RouterLinkActive` directive to a string of classes such as `[routerLinkActive]="'active fluffy'"`
|
||
or bind it to a component property that returns such a string.
|
||
|
||
等号（=）右侧的模板表达式包含用空格分隔的一些CSS类。当路由激活时路由器就会把它们添加到此链接上（反之则移除）。我们还可以把`RouterLinkActive`指令绑定到一个CSS类组成的数组，如`[routerLinkActive]="['...']"`。
|
||
|
||
The `RouterLinkActive` directive toggles css classes for active `RouterLink`s based on the current `RouterState`.
|
||
This cascades down through each level of the route tree, so parent and child router links can be active at the same time.
|
||
To override this behavior, you can bind to the `[routerLinkActiveOptions]` input binding with the `{ exact: true }` expression.
|
||
By using `{ exact: true }`, a given `RouterLink` will only be active if its URL is an exact match to the current URL.
|
||
|
||
`RouterLinkActive`指令会基于当前的`RouterState`对象来为激活的`RouterLink`切换CSS类。
|
||
这会一直沿着路由树往下进行级联处理，所以父路由链接和子路由链接可能会同时激活。
|
||
要改变这种行为，可以把`[routerLinkActiveOptions]`绑定到`{exact: true}`表达式。
|
||
如果使用了`{ exact: true }`，那么只有在其URL与当前URL精确匹配时才会激活指定的`RouterLink`。
|
||
|
||
|
||
{@a router-directives}
|
||
|
||
|
||
### *Router directives*
|
||
|
||
### *路由器指令集*
|
||
|
||
`RouterLink`, `RouterLinkActive` and `RouterOutlet` are directives provided by the Angular `RouterModule` package.
|
||
They are readily available for you to use in the template.
|
||
|
||
`RouterLink`、`RouterLinkActive`和`RouterOutlet`是由`RouterModule`包提供的指令。
|
||
现在它已经可用于我们自己的模板中。
|
||
|
||
The current state of `app.component.ts` looks like this:
|
||
|
||
`app.component.ts`目前是这样的：
|
||
|
||
|
||
<code-example path="router/src/app/app.component.1.ts" linenums="false" title="src/app/app.component.ts (excerpt)">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
{@a wildcard}
|
||
|
||
|
||
### Wildcard route
|
||
|
||
### 通配符路由
|
||
|
||
You've created two routes in the app so far, one to `/crisis-center` and the other to `/heroes`.
|
||
Any other URL causes the router to throw an error and crash the app.
|
||
|
||
我们以前在应用中创建过两个路由，一个是`/crisis-center`，另一个是`/heroes`。
|
||
所有其它URL都会导致路由器抛出错误，并让应用崩溃。
|
||
|
||
Add a **wildcard** route to intercept invalid URLs and handle them gracefully.
|
||
A _wildcard_ route has a path consisting of two asterisks. It matches _every_ URL.
|
||
The router will select _this_ route if it can't match a route earlier in the configuration.
|
||
A wildcard route can navigate to a custom "404 Not Found" component or [redirect](#redirect) to an existing route.
|
||
|
||
可以添加一个**通配符**路由来拦截所有无效的URL，并优雅的处理它们。
|
||
*通配符*路由的`path`是两个星号（`**`），它会匹配*任何* URL。
|
||
当路由器匹配不上以前定义的那些路由时，它就会选择*这个*路由。
|
||
通配符路由可以导航到自定义的“404 Not Found”组件，也可以[重定向](guide/router#redirect)到一个现有路由。
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
The router selects the route with a [_first match wins_](#example-config) strategy.
|
||
Wildcard routes are the least specific routes in the route configuration.
|
||
Be sure it is the _last_ route in the configuration.
|
||
|
||
路由器使用[先匹配者优先](guide/router#example-config)的策略来选择路由。
|
||
通配符路由是路由配置中最没有特定性的那个，因此务必确保它是配置中的*最后一个*路由。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
To test this feature, add a button with a `RouterLink` to the `HeroListComponent` template and set the link to `"/sidekicks"`.
|
||
|
||
要测试本特性，请往`HeroListComponent`的模板中添加一个带`RouterLink`的按钮，并且把它的链接设置为`"/sidekicks"`。
|
||
|
||
|
||
<code-example path="router/src/app/hero-list.component.ts" linenums="false" title="src/app/hero-list.component.ts (excerpt)">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
The application will fail if the user clicks that button because you haven't defined a `"/sidekicks"` route yet.
|
||
|
||
当用户点击该按钮时，应用就会失败，因为我们尚未定义过`"/sidekicks"`路由。
|
||
|
||
Instead of adding the `"/sidekicks"` route, define a `wildcard` route instead and have it navigate to a simple `PageNotFoundComponent`.
|
||
|
||
不要添加`"/sidekicks"`路由，而是定义一个“通配符”路由，让它直接导航到`PageNotFoundComponent`组件。
|
||
|
||
|
||
<code-example path="router/src/app/app.module.1.ts" linenums="false" title="src/app/app.module.ts (wildcard)" region="wildcard">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Create the `PageNotFoundComponent` to display when users visit invalid URLs.
|
||
|
||
创建`PageNotFoundComponent`，以便在用户访问无效网址时显示它。
|
||
|
||
|
||
<code-example path="router/src/app/not-found.component.ts" linenums="false" title="src/app/not-found.component.ts (404 component)">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
As with the other components, add the `PageNotFoundComponent` to the `AppModule` declarations.
|
||
|
||
像其它组件一样，把`PageNotFoundComponent`添加到`AppModule`的声明中。
|
||
|
||
Now when the user visits `/sidekicks`, or any other invalid URL, the browser displays "Page not found".
|
||
The browser address bar continues to point to the invalid URL.
|
||
|
||
现在，当用户访问`/sidekicks`或任何无效的URL时，浏览器就会显示“Page not found”。
|
||
浏览器的地址栏仍指向无效的URL。
|
||
|
||
|
||
{@a default-route}
|
||
|
||
|
||
### The _default_ route to heroes
|
||
|
||
### 把*默认*路由设置为英雄列表
|
||
|
||
When the application launches, the initial URL in the browser bar is something like:
|
||
|
||
应用启动时，浏览器地址栏中的初始URL是这样的：
|
||
|
||
|
||
<code-example>
|
||
localhost:3000
|
||
</code-example>
|
||
|
||
That doesn't match any of the concrete configured routes which means
|
||
the router falls through to the wildcard route and displays the `PageNotFoundComponent`.
|
||
|
||
The application needs a **default route** to a valid page.
|
||
The default page for this app is the list of heroes.
|
||
The app should navigate there as if the user clicked the "Heroes" link or pasted `localhost:3000/heroes` into the address bar.
|
||
|
||
{@a redirect}
|
||
|
||
### Redirecting routes
|
||
|
||
### 重定向路由
|
||
|
||
The preferred solution is to add a `redirect` route that translates the initial relative URL (`''`)
|
||
to the desired default path (`/heroes`). The browser address bar shows `.../heroes` as if you'd navigated there directly.
|
||
|
||
首选方案是添加一个`redirect`路由来把最初的相对路径（`''`）转换成期望的默认路径（`/heroes`）。
|
||
浏览器地址栏会显示`.../heroes`，就像你直接导航到那里一样。
|
||
|
||
Add the default route somewhere _above_ the wildcard route.
|
||
It's just above the wildcard route in the following excerpt showing the complete `appRoutes` for this milestone.
|
||
|
||
在通配符路由*上方*添加一个默认路由。
|
||
在下方的代码片段中，它出现在通配符路由的紧上方，展示了这个里程碑的完整`appRoutes`。
|
||
|
||
|
||
<code-example path="router/src/app/app-routing.module.1.ts" linenums="false" title="src/app/app-routing.module.ts (appRoutes)" region="appRoutes">
|
||
</code-example>
|
||
|
||
|
||
|
||
A redirect route requires a `pathMatch` property to tell the router how to match a URL to the path of a route.
|
||
The router throws an error if you don't.
|
||
In this app, the router should select the route to the `HeroListComponent` only when the *entire URL* matches `''`,
|
||
so set the `pathMatch` value to `'full'`.
|
||
|
||
重定向路由需要一个`pathMatch`属性，来告诉路由器如何用URL去匹配路由的路径，否则路由器就会报错。
|
||
在本应用中，路由器应该只有在*完整的URL*等于`''`时才选择`HeroListComponent`组件，因此我们要把`pathMatch`设置为`'full'`。
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
Technically, `pathMatch = 'full'` results in a route hit when the *remaining*, unmatched segments of the URL match `''`.
|
||
In this example, the redirect is in a top level route so the *remaining* URL and the *entire* URL are the same thing.
|
||
|
||
从技术角度说，`pathMatch = 'full'`导致URL中*剩下的*、未匹配的部分必须等于`''`。
|
||
在这个例子中，跳转路由在一个顶级路由中，因此*剩下的*URL和*完整的*URL是一样的。
|
||
|
||
The other possible `pathMatch` value is `'prefix'` which tells the router
|
||
to match the redirect route when the *remaining* URL ***begins*** with the redirect route's _prefix_ path.
|
||
|
||
`pathMatch`的另一个可能的值是`'prefix'`，它会告诉路由器：当*剩下的*URL以这个跳转路由中的`prefix`值开头时，就会匹配上这个跳转路由。
|
||
|
||
Don't do that here.
|
||
If the `pathMatch` value were `'prefix'`, _every_ URL would match `''`.
|
||
|
||
在这里不能这么做！如果`pathMatch`的值是`'prefix'`，那么*每个*URL都会匹配上`''`。
|
||
|
||
Try setting it to `'prefix'` then click the `Go to sidekicks` button.
|
||
Remember that's a bad URL and you should see the "Page not found" page.
|
||
Instead, you're still on the "Heroes" page.
|
||
Enter a bad URL in the browser address bar.
|
||
You're instantly re-routed to `/heroes`.
|
||
_Every_ URL, good or bad, that falls through to _this_ route definition
|
||
will be a match.
|
||
|
||
尝试把它设置为`'prefix'`，然后点击`Go to sidekicks`按钮。别忘了，它是一个无效URL，本应显示“Page not found”页。
|
||
但是，我们看到了“英雄列表”页。在地址栏中输入一个无效的URL，我们又被路由到了`/heroes`。
|
||
*每一个*URL，无论有效与否，都会匹配上这个路由定义。
|
||
|
||
The default route should redirect to the `HeroListComponent` _only_ when the _entire_ url is `''`.
|
||
Remember to restore the redirect to `pathMatch = 'full'`.
|
||
|
||
默认路由应该只有在*整个*URL等于`''`时才重定向到`HeroListComponent`，别忘了把重定向路由设置为`pathMatch = 'full'`。
|
||
|
||
Learn more in Victor Savkin's
|
||
[post on redirects](http://victorsavkin.com/post/146722301646/angular-router-empty-paths-componentless-routes).
|
||
|
||
要了解更多，参见Victor Savkin的帖子[关于重定向](http://victorsavkin.com/post/146722301646/angular-router-empty-paths-componentless-routes)。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
### Basics wrap up
|
||
|
||
### “起步阶段”总结
|
||
|
||
You've got a very basic navigating app, one that can switch between two views
|
||
when the user clicks a link.
|
||
|
||
我们得到了一个非常基本的、带导航的应用，当用户点击链接时，它能在两个视图之间切换。
|
||
|
||
You've learned how to do the following:
|
||
|
||
我们已经学会了如何：
|
||
|
||
* Load the router library.
|
||
|
||
加载路由库
|
||
|
||
* Add a nav bar to the shell template with anchor tags, `routerLink` and `routerLinkActive` directives.
|
||
|
||
往壳组件的模板中添加一个导航条，导航条中有一些A标签、`routerLink`指令和`routerLinkActive`指令
|
||
|
||
* Add a `router-outlet` to the shell template where views will be displayed.
|
||
|
||
往壳组件的模板中添加一个`router-outlet`指令，视图将会被显示在那里
|
||
|
||
* Configure the router module with `RouterModule.forRoot`.
|
||
|
||
用`RouterModule.forRoot`配置路由器模块
|
||
|
||
* Set the router to compose HTML5 browser URLs.
|
||
|
||
设置路由器，使其合成HTML5模式的浏览器URL。
|
||
|
||
* handle invalid routes with a `wildcard` route.
|
||
|
||
使用通配符路由来处理无效路由
|
||
|
||
* navigate to the default route when the app launches with an empty path.
|
||
|
||
当应用在空路径下启动时，导航到默认路由
|
||
|
||
|
||
The rest of the starter app is mundane, with little interest from a router perspective.
|
||
Here are the details for readers inclined to build the sample through to this milestone.
|
||
|
||
这个初学者应用的其它部分有点平淡无奇，从路由器的角度来看也很平淡。
|
||
如果你还是倾向于在这个里程碑里构建它们，参见下面的构建详情。
|
||
|
||
The starter app's structure looks like this:
|
||
|
||
这个初学者应用的结构是这样的：
|
||
|
||
|
||
<div class='filetree'>
|
||
|
||
<div class='file'>
|
||
router-sample
|
||
</div>
|
||
|
||
<div class='children'>
|
||
|
||
<div class='file'>
|
||
src
|
||
</div>
|
||
|
||
<div class='children'>
|
||
|
||
<div class='file'>
|
||
app
|
||
</div>
|
||
|
||
<div class='children'>
|
||
|
||
<div class='file'>
|
||
app.component.ts
|
||
</div>
|
||
|
||
<div class='file'>
|
||
app.module.ts
|
||
</div>
|
||
|
||
<div class='file'>
|
||
crisis-list.component.ts
|
||
</div>
|
||
|
||
<div class='file'>
|
||
hero-list.component.ts
|
||
</div>
|
||
|
||
<div class='file'>
|
||
not-found.component.ts
|
||
</div>
|
||
|
||
</div>
|
||
|
||
<div class='file'>
|
||
main.ts
|
||
</div>
|
||
|
||
<div class='file'>
|
||
index.html
|
||
</div>
|
||
|
||
<div class='file'>
|
||
styles.css
|
||
</div>
|
||
|
||
<div class='file'>
|
||
tsconfig.json
|
||
</div>
|
||
|
||
</div>
|
||
|
||
<div class='file'>
|
||
node_modules ...
|
||
</div>
|
||
|
||
<div class='file'>
|
||
package.json
|
||
</div>
|
||
|
||
</div>
|
||
|
||
</div>
|
||
|
||
|
||
|
||
Here are the files discussed in this milestone.
|
||
|
||
下面是当前里程碑中讨论过的文件列表：
|
||
|
||
|
||
<code-tabs>
|
||
|
||
<code-pane title="app.component.ts" path="router/src/app/app.component.1.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="app.module.ts" path="router/src/app/app.module.1.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="main.ts" path="router/src/main.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="hero-list.component.ts" path="router/src/app/hero-list.component.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="crisis-list.component.ts" path="router/src/app/crisis-list.component.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="not-found.component.ts" path="router/src/app/not-found.component.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="index.html" path="router/src/index.html">
|
||
|
||
</code-pane>
|
||
|
||
</code-tabs>
|
||
|
||
|
||
{@a routing-module}
|
||
|
||
## Milestone 2: *Routing module*
|
||
|
||
## 里程碑 #2：**路由模块**
|
||
|
||
In the initial route configuration, you provided a simple setup with two routes used
|
||
to configure the application for routing. This is perfectly fine for simple routing.
|
||
As the application grows and you make use of more `Router` features, such as guards,
|
||
resolvers, and child routing, you'll naturally want to refactor the routing configuration into its own file.
|
||
We recommend moving the routing information into a special-purpose module called a *Routing Module*.
|
||
|
||
在原始的路由配置中，我们提供了仅有两个路由的简单配置来设置应用的路由。对于简单的路由，这没有问题。
|
||
随着应用的成长，我们使用更多**路由器**特征，比如守卫、解析器和子路由等，我们很自然想要重构路由。
|
||
建议将路由信息移到一个单独的特殊用途的模块，叫做**路由模块**。
|
||
|
||
The **Routing Module** has several characteristics:
|
||
|
||
**路由模块**有一系列特性：
|
||
|
||
* Separates routing concerns from other application concerns.
|
||
|
||
把路由这个关注点从其它应用类关注点中分离出去
|
||
|
||
* Provides a module to replace or remove when testing the application.
|
||
|
||
测试特性模块时，可以替换或移除路由模块
|
||
|
||
* Provides a well-known location for routing service providers including guards and resolvers.
|
||
|
||
为路由服务提供商（包括守卫和解析器等）提供一个共同的地方
|
||
|
||
* Does **not** [declare components](guide/ngmodule-faq#routing-module).
|
||
|
||
**不要**[声明组件](guide/ngmodule-faq#routing-module)
|
||
|
||
|
||
{@a routing-refactor}
|
||
|
||
|
||
### Refactor the routing configuration into a _routing module_
|
||
|
||
### 将路由配置重构为*路由模块*
|
||
|
||
Create a file named `app-routing.module.ts` in the `/app` folder to contain the routing module.
|
||
|
||
在`/app`目录下创建一个名叫`app-routing.module.ts`的文件，以包含这个路由模块。
|
||
|
||
Import the `CrisisListComponent` and the `HeroListComponent` components
|
||
just like you did in the `app.module.ts`. Then move the `Router` imports
|
||
and routing configuration, including `RouterModule.forRoot`, into this routing module.
|
||
|
||
导入`CrisisListComponent`和`HeroListComponent`组件，就像`app.module.ts`中一样。然后把`Router`的导入语句和路由配置以及`RouterModule.forRoot`移入这个路由模块中。
|
||
|
||
Following convention, add a class name `AppRoutingModule` and export it
|
||
so you can import it later in `AppModule`.
|
||
|
||
遵循规约，添加一个`AppRoutingModule`类并导出它，以便稍后在`AppModule`中导入它。
|
||
|
||
Finally, re-export the Angular `RouterModule` by adding it to the module `exports` array.
|
||
By re-exporting the `RouterModule` here and importing `AppRoutingModule` in `AppModule`,
|
||
the components declared in `AppModule` will have access to router directives such as `RouterLink` and `RouterOutlet`.
|
||
|
||
最后，可以通过把它添加到该模块的`exports`数组中来再次导出`RouterModule`。
|
||
通过在`AppModule`中导入`AppRoutingModule`并再次导出`RouterModule`，那些声明在`AppModule`中的组件就可以访问路由指令了，比如`RouterLink` 和 `RouterOutlet`。
|
||
|
||
After these steps, the file should look like this.
|
||
|
||
做完这些之后，该文件变成了这样：
|
||
|
||
|
||
<code-example path="router/src/app/app-routing.module.1.ts" title="src/app/app-routing.module.ts">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Next, update the `app.module.ts` file,
|
||
first importing the newly created `AppRoutingModule` from `app-routing.module.ts`,
|
||
then replacing `RouterModule.forRoot` in the `imports` array with the `AppRoutingModule`.
|
||
|
||
接下来，修改`app.module.ts`文件，首先从`app-routing.module.ts`中导入新创建的`AppRoutingModule`，
|
||
然后把`imports`数组中的`RouterModule.forRoot`替换为`AppRoutingModule`。
|
||
|
||
|
||
<code-example path="router/src/app/app.module.2.ts" title="src/app/app.module.ts">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
Later in this guide you will create [multiple routing modules](#hero-routing-module) and discover that
|
||
you must import those routing modules [in the correct order](#routing-module-order).
|
||
|
||
本章稍后的部分，我们将创建一个[多路由模块](guide/router#hero-routing-module)，并讲解为何我们必须[以正确的顺序导入那些路由模块](guide/router#routing-module-order)。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
The application continues to work just the same, and you can use `AppRoutingModule` as
|
||
the central place to maintain future routing configuration.
|
||
|
||
应用继续正常运行，我们可以把路由模块作为为每个特性模块维护路由配置的中心地方。
|
||
|
||
|
||
{@a why-routing-module}
|
||
|
||
|
||
### Do you need a _Routing Module_?
|
||
|
||
### 你需要**路由模块**吗？
|
||
|
||
The _Routing Module_ *replaces* the routing configuration in the root or feature module.
|
||
_Either_ configure routes in the Routing Module _or_ within the module itself but not in both.
|
||
|
||
**路由模块**在根模块或者特性模块替换了路由配置。在路由模块或者在模块内部配置路由，但不要同时在两处都配置。
|
||
|
||
The Routing Module is a design choice whose value is most obvious when the configuration is complex
|
||
and includes specialized guard and resolver services.
|
||
It can seem like overkill when the actual configuration is dead simple.
|
||
|
||
路由模块是设计选择，它的价值在配置很复杂，并包含专门守卫和解析器服务时尤其明显。
|
||
在配置很简单时，它可能看起来很多余。
|
||
|
||
Some developers skip the Routing Module (for example, `AppRoutingModule`) when the configuration is simple and
|
||
merge the routing configuration directly into the companion module (for example, `AppModule`).
|
||
|
||
在配置很简单时，一些开发者跳过路由模块（例如`AppRoutingModule`），并将路由配置直接混合在关联模块中（比如`AppModule` ）。
|
||
|
||
Choose one pattern or the other and follow that pattern consistently.
|
||
|
||
我们建议你选择其中一种模式，并坚持模式的一致性。
|
||
|
||
Most developers should always implement a Routing Module for the sake of consistency.
|
||
|
||
大多数开发者应该采用路由模块，以保持一致性。
|
||
|
||
It keeps the code clean when configuration becomes complex.
|
||
It makes testing the feature module easier.
|
||
Its existence calls attention to the fact that a module is routed.
|
||
It is where developers expect to find and expand routing configuration.
|
||
|
||
它在配置复杂时，能确保代码干净。
|
||
它让测试特性模块更加容易。
|
||
它的存在突出了模块时被路由的事实。
|
||
开发者可以很自然的从路由模块中查找和扩展路由配置。
|
||
|
||
{@a heroes-feature}
|
||
|
||
## Milestone 3: Heroes feature
|
||
|
||
## 里程碑 #2 英雄特征区
|
||
|
||
You've seen how to navigate using the `RouterLink` directive.
|
||
Now you'll learn the following:
|
||
|
||
我们刚刚学习了如何用`RouterLink`指令进行导航。接下来我们将到：
|
||
|
||
* Organize the app and routes into *feature areas* using modules.
|
||
|
||
用模块把应用和路由组织为一些*特性区*
|
||
|
||
* Navigate imperatively from one component to another.
|
||
|
||
命令式地从一个组件导航到另一个组件
|
||
|
||
* Pass required and optional information in route parameters.
|
||
|
||
通过路由传递必要信息和可选信息
|
||
|
||
This example recreates the heroes feature in the "Services" episode of the
|
||
[Tour of Heroes tutorial](tutorial/toh-pt4 "Tour of Heroes: Services"),
|
||
and you'll be copying much of the code
|
||
from the <live-example name="toh-pt4" title="Tour of Heroes: Services example code"></live-example>.
|
||
|
||
这个例子重写了[《英雄指南》](tutorial/toh-pt4 "Tour of Heroes: Services")的“服务”部分的英雄列表特性，我们可以从<live-example name="toh-4" title="Tour of Heroes: Services example code"></live-example>中赋值大部分代码过来。
|
||
|
||
Here's how the user will experience this version of the app:
|
||
|
||
下面是用户将看到的版本：
|
||
|
||
|
||
<figure>
|
||
<img src='generated/images/guide/router/router-2-anim.gif' alt="App in action">
|
||
</figure>
|
||
|
||
|
||
|
||
A typical application has multiple *feature areas*,
|
||
each dedicated to a particular business purpose.
|
||
|
||
典型的应用具有多个*特性区*，每个特性区都专注于特定的业务用途。
|
||
|
||
While you could continue to add files to the `src/app/` folder,
|
||
that is unrealistic and ultimately not maintainable.
|
||
Most developers prefer to put each feature area in its own folder.
|
||
|
||
虽然我们也可以把文件都放在`src/app/`目录下，但那样是不现实的，而且很难维护。
|
||
大部分开发人员更喜欢把每个特性区都放在它自己的目录下。
|
||
|
||
You are about to break up the app into different *feature modules*, each with its own concerns.
|
||
Then you'll import into the main module and navigate among them.
|
||
|
||
我们准备把应用拆分成多个不同的*特性模块*，每个特有模块都有自己的关注点。
|
||
然后，我们就会把它们导入到主模块中，并且在它们之间导航。
|
||
|
||
|
||
{@a heroes-functionality}
|
||
|
||
|
||
### Add heroes functionality
|
||
|
||
### 添加英雄管理功能
|
||
|
||
Follow these steps:
|
||
|
||
按照下列步骤：
|
||
|
||
* Create the `src/app/heroes` folder; you'll be adding files implementing *hero management* there.
|
||
|
||
创建`src/app/heroes`文件夹，我们将会把*英雄管理*功能的实现文件放在这里。
|
||
|
||
* Delete the placeholder `hero-list.component.ts` that's in the `app` folder.
|
||
|
||
在`app`目录下删除占位用的`hero-list.component.ts`文件。
|
||
|
||
* Create a new `hero-list.component.ts` under `src/app/heroes`.
|
||
|
||
在`src/app/heroes`目录下创建新的`hero-list.component.ts`文件。
|
||
|
||
* Copy into it the contents of the `app.component.ts` from
|
||
the <live-example name="toh-pt4" title="Tour of Heroes: Services example code">"Services" tutorial</live-example>.
|
||
|
||
把<live-example name="toh-4" title="Tour of Heroes: Services example code">教程中的“服务”部分</live-example>的代码复制到`app.component.ts`中。
|
||
|
||
* Make a few minor but necessary changes:
|
||
|
||
做一些微小但必要的修改：
|
||
|
||
* Delete the `selector` (routed components don't need them).
|
||
|
||
删除`selector`（路由组件不需要它们）。
|
||
|
||
* Delete the `<h1>`.
|
||
|
||
删除`<h1>`。
|
||
|
||
* Relabel the `<h2>` to `<h2>HEROES</h2>`.
|
||
|
||
给`<h2>`加文字，改成`<h2>HEROES</h2>`。
|
||
|
||
* Delete the `<hero-detail>` at the bottom of the template.
|
||
|
||
删除模板底部的`<hero-detail>`。
|
||
|
||
* Rename the `AppComponent` class to `HeroListComponent`.
|
||
|
||
把`AppComponent`类改名为`HeroListComponent`。
|
||
|
||
* Copy the `hero-detail.component.ts` and the `hero.service.ts` files into the `heroes` subfolder.
|
||
|
||
把`hero-detail.component.ts`和`hero.service.ts`复制到`heroes`子目录下。
|
||
|
||
* Create a (pre-routing) `heroes.module.ts` in the heroes folder that looks like this:
|
||
|
||
在`heroes`子目录下（不带路由）的`heroes.module.ts`文件，内容如下：
|
||
|
||
|
||
<code-example path="router/src/app/heroes/heroes.module.ts" region="v1" title="src/app/heroes/heroes.module.ts (pre-routing)">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
When you're done, you'll have these *hero management* files:
|
||
|
||
安排完这些，我们就有了四个*英雄管理*特性区的文件：
|
||
|
||
|
||
<div class='filetree'>
|
||
|
||
<div class='file'>
|
||
src/app/heroes
|
||
</div>
|
||
|
||
<div class='children'>
|
||
|
||
<div class='file'>
|
||
hero-detail.component.ts
|
||
</div>
|
||
|
||
<div class='file'>
|
||
hero-list.component.ts
|
||
</div>
|
||
|
||
<div class='file'>
|
||
hero.service.ts
|
||
</div>
|
||
|
||
<div class='file'>
|
||
heroes.module.ts
|
||
</div>
|
||
|
||
</div>
|
||
|
||
</div>
|
||
|
||
|
||
|
||
{@a hero-routing-requirements}
|
||
|
||
|
||
### *Hero* feature routing requirements
|
||
|
||
### *英雄*特性区的路由需求
|
||
|
||
The heroes feature has two interacting components, the hero list and the hero detail.
|
||
The list view is self-sufficient; you navigate to it, it gets a list of heroes and displays them.
|
||
|
||
“英雄”特性有两个相互协作的组件，列表和详情。
|
||
列表视图是自给自足的，我们导航到它，它会自行获取英雄列表并显示它们。
|
||
|
||
The detail view is different. It displays a particular hero. It can't know which hero to show on its own.
|
||
That information must come from outside.
|
||
|
||
详情视图就不同了。它要显示一个特定的英雄，但是它本身却无法知道显示哪一个，此信息必须来自外部。
|
||
|
||
When the user selects a hero from the list, the app should navigate to the detail view
|
||
and show that hero.
|
||
You tell the detail view which hero to display by including the selected hero's id in the route URL.
|
||
|
||
当用户从列表中选择了一个英雄时，我们就导航到详情页以显示那个英雄。
|
||
通过把所选英雄的id编码进路由的URL中，就能告诉详情视图该显示哪个英雄。
|
||
|
||
|
||
{@a hero-routing-module}
|
||
|
||
|
||
### *Hero* feature route configuration
|
||
|
||
### *英雄*特性区的路由配置
|
||
|
||
Create a new `heroes-routing.module.ts` in the `heroes` folder
|
||
using the same techniques you learned while creating the `AppRoutingModule`.
|
||
|
||
在`heroes`目录下创建一个新的`heroes-routing.module.ts`文件，使用的技术和以前创建`AppRoutingModule`时的一样。
|
||
|
||
|
||
<code-example path="router/src/app/heroes/heroes-routing.module.ts" title="src/app/heroes/heroes-routing.module.ts">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
Put the routing module file in the same folder as its companion module file.
|
||
Here both `heroes-routing.module.ts` and `heroes.module.ts` are in the same `src/app/heroes` folder.
|
||
|
||
把路由模块文件和它对应的模块文件放在同一个目录下。
|
||
比如这里的`heroes-routing.module.ts`和`heroes.module.ts`都位于`src/app/heroes`目录下。
|
||
|
||
Consider giving each feature module its own route configuration file.
|
||
It may seem like overkill early when the feature routes are simple.
|
||
But routes have a tendency to grow more complex and consistency in patterns pays off over time.
|
||
|
||
将路由模块文件放到它相关的模块文件所在目录里。
|
||
这里，`heroes-routing.module.ts`和`heroes.module.ts`都在`app/heroes`目录中。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
Import the hero components from their new locations in the `src/app/heroes/` folder, define the two hero routes,
|
||
and export the `HeroRoutingModule` class.
|
||
|
||
从新位置`src/app/heroes/`目录中导入英雄相关的组件，定义两个“英雄管理”路由，并导出`HeroRoutingModule`类。
|
||
|
||
Now that you have routes for the `Heroes` module, register them with the `Router` via the
|
||
`RouterModule` _almost_ as you did in the `AppRoutingModule`.
|
||
|
||
现在，我们有了`Heroes`模块的路由，还得在`RouterModule`中把它们注册给*路由器*，和`AppRoutingModule`中的做法几乎完全一样。
|
||
|
||
There is a small but critical difference.
|
||
In the `AppRoutingModule`, you used the static **`RouterModule.forRoot`** method to register the routes and application level service providers.
|
||
In a feature module you use the static **`forChild`** method.
|
||
|
||
这里有少量但是关键的不同点。
|
||
在`AppRoutingModule`中，我们使用了静态的`RouterModule.`**`forRoot`**方法来注册我们的路由和全应用级服务提供商。
|
||
在特性模块中，我们要改用**`forChild`**静态方法。
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
Only call `RouterModule.forRoot` in the root `AppRoutingModule`
|
||
(or the `AppModule` if that's where you register top level application routes).
|
||
In any other module, you must call the **`RouterModule.forChild`** method to register additional routes.
|
||
|
||
只在根模块`AppRoutingModule`中调用`RouterModule.forRoot`（如果在`AppModule`中注册应用的顶级路由，那就在`AppModule`中调用）。
|
||
在其它模块中，我们就必须调用**`RouterModule.forChild`**方法来注册附属路由。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
{@a adding-routing-module}
|
||
|
||
|
||
### Add the routing module to the _HeroesModule_
|
||
|
||
### 把路由模块添加到`HeroesModule`中
|
||
|
||
Add the `HeroRoutingModule` to the `HeroModule`
|
||
just as you added `AppRoutingModule` to the `AppModule`.
|
||
|
||
我们在`Heroes`模块中从`heroes-routing.module.ts`中导入`HeroRoutingModule`，并注册其路由。
|
||
|
||
Open `heroes.module.ts`.
|
||
Import the `HeroRoutingModule` token from `heroes-routing.module.ts` and
|
||
add it to the `imports` array of the `HeroesModule`.
|
||
The finished `HeroesModule` looks like this:
|
||
|
||
打开`heroes.module.ts`，从`heroes-routing.module.ts`中导入`HeroRoutingModule`并把它添加到`HeroesModule`的`imports`数组中。
|
||
写完后的`HeroesModule`是这样的：
|
||
|
||
|
||
<code-example path="router/src/app/heroes/heroes.module.ts" title="src/app/heroes/heroes.module.ts">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
{@a remove-duplicate-hero-routes}
|
||
|
||
|
||
### Remove duplicate hero routes
|
||
|
||
### 移除重复的“英雄管理”路由
|
||
|
||
The hero routes are currently defined in _two_ places: in the `HeroesRoutingModule`,
|
||
by way of the `HeroesModule`, and in the `AppRoutingModule`.
|
||
|
||
英雄类的路由目前定义在两个地方：`HeroesRoutingModule`中（并最终给`HeroesModule`）和`AppRoutingModule`中。
|
||
|
||
Routes provided by feature modules are combined together into their imported module's routes by the router.
|
||
This allows you to continue defining the feature module routes without modifying the main route configuration.
|
||
|
||
由特性模块提供的路由会被路由器再组合上它们所导入的模块的路由。
|
||
这让我们可以继续定义特性路由模块中的路由，而不用修改主路由配置。
|
||
|
||
But you don't want to define the same routes twice.
|
||
Remove the `HeroListComponent` import and the `/heroes` route from the `app-routing.module.ts`.
|
||
|
||
但我们显然不会想把同一个路由定义两次，那就移除`HeroListComponent`的导入和来自`app-routing.module.ts`中的`/heroes`路由。
|
||
|
||
**Leave the default and the wildcard routes!**
|
||
These are concerns at the top level of the application itself.
|
||
|
||
**保留默认路由和通配符路由！**
|
||
它们是应用程序顶层该自己处理的关注点。
|
||
|
||
|
||
<code-example path="router/src/app/app-routing.module.2.ts" linenums="false" title="src/app/app-routing.module.ts (v2)">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
{@a merge-hero-routes}
|
||
|
||
|
||
### Import hero module into AppModule
|
||
|
||
### 把“英雄管理”模块导入到AppModule
|
||
|
||
The heroes feature module is ready, but the application doesn't know about the `HeroesModule` yet.
|
||
Open `app.module.ts` and revise it as follows.
|
||
|
||
英雄这个特性模块已经就绪，但应用仍然不知道`HeroesModule`的存在。
|
||
打开`app.module.ts`，并按照下述步骤修改它。
|
||
|
||
Import the `HeroesModule` and add it to the `imports` array in the `@NgModule` metadata of the `AppModule`.
|
||
|
||
导入`HeroesModule`并且把它加到根模块`AppModule`的`@NgModule`元数据中的`imports`数组中。
|
||
|
||
Remove the `HeroListComponent` from the `AppModule`'s `declarations` because it's now provided by the `HeroesModule`.
|
||
This is important. There can be only _one_ owner for a declared component.
|
||
In this case, the `Heroes` module is the owner of the `Heroes` components and is making them available to
|
||
components in the `AppModule` via the `HeroesModule`.
|
||
|
||
从`AppModule`的`declarations`中移除`HeroListComponent`，因为它现在已经改由`HeroesModule`提供了。
|
||
这一步很重要！因为一个组件只能声明在*一个*属主模块中。
|
||
这个例子中，`Heroes`模块就是`Heroes`组件的属主模块，而`AppModule`要通过导入`HeroesModule`才能使用这些组件。
|
||
|
||
As a result, the `AppModule` no longer has specific knowledge of the hero feature, its components, or its route details.
|
||
You can evolve the hero feature with more components and different routes.
|
||
That's a key benefit of creating a separate module for each feature area.
|
||
|
||
最终，`AppModule`不再了解那些特定于“英雄”特性的知识，比如它的组件、路由细节等。
|
||
我们可以让“英雄”特性独立演化，添加更多的组件或各种各样的路由。
|
||
这是我们为每个特性区创建独立模块后获得的核心优势。
|
||
|
||
After these steps, the `AppModule` should look like this:
|
||
|
||
经过这些步骤，`AppModule`变成了这样：
|
||
|
||
|
||
<code-example path="router/src/app/app.module.3.ts" title="src/app/app.module.ts">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
{@a routing-module-order}
|
||
|
||
|
||
### Module import order matters
|
||
|
||
### 导入模块的顺序很重要
|
||
|
||
Look at the module `imports` array. Notice that the `AppRoutingModule` is _last_.
|
||
Most importantly, it comes _after_ the `HeroesModule`.
|
||
|
||
看看该模块的`imports`数组。注意，`AppRoutingModule`是*最后一个*。最重要的是，它位于`HeroesModule`之后。
|
||
|
||
|
||
<code-example path="router/src/app/app.module.3.ts" region="module-imports" title="src/app/app.module.ts (module-imports)" linenums="false">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
The order of route configuration matters.
|
||
The router accepts the first route that matches a navigation request path.
|
||
|
||
路由配置的顺序很重要。
|
||
路由器会接受第一个匹配上导航所要求的路径的那个路由。
|
||
|
||
When all routes were in one `AppRoutingModule`,
|
||
you put the default and [wildcard](#wildcard) routes last, after the `/heroes` route,
|
||
so that the router had a chance to match a URL to the `/heroes` route _before_
|
||
hitting the wildcard route and navigating to "Page not found".
|
||
|
||
当所有路由都在同一个`AppRoutingModule`时，我们要把默认路由和[通配符路由](guide/router#wildcard)放在最后（这里是在`/heroes`路由后面），
|
||
这样路由器才有机会匹配到`/heroes`路由，否则它就会先遇到并匹配上该通配符路由，并导航到“页面未找到”路由。
|
||
|
||
The routes are no longer in one file.
|
||
They are distributed across two modules, `AppRoutingModule` and `HeroesRoutingModule`.
|
||
|
||
这些路由不再位于单一文件中。他们分布在两个不同的模块中：`AppRoutingModule`和`HeroesRoutingModule`。
|
||
|
||
Each routing module augments the route configuration _in the order of import_.
|
||
If you list `AppRoutingModule` first, the wildcard route will be registered
|
||
_before_ the hero routes.
|
||
The wildcard route — which matches _every_ URL —
|
||
will intercept the attempt to navigate to a hero route.
|
||
|
||
每个路由模块都会根据*导入的顺序*把自己的路由配置追加进去。
|
||
如果我们先列出了`AppRoutingModule`，那么通配符路由就会被注册在“英雄管理”路由*之前*。
|
||
通配符路由（它匹配*任意*URL）将会拦截住每一个到“英雄管理”路由的导航，因此事实上屏蔽了所有“英雄管理”路由。
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
Reverse the routing modules and see for yourself that
|
||
a click of the heroes link results in "Page not found".
|
||
Learn about inspecting the runtime router configuration
|
||
[below](#inspect-config "Inspect the router config").
|
||
|
||
反转路由模块的导入顺序，我们就会看到当点击英雄相关的链接时被导向了“页面未找到”路由。
|
||
要学习如何在运行时查看路由器配置，参见[稍后的内容](guide/router#inspect-config "Inspect the router config")。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
{@a route-def-with-parameter}
|
||
|
||
|
||
### Route definition with a parameter
|
||
|
||
### 带参数的路由定义
|
||
|
||
Return to the `HeroesRoutingModule` and look at the route definitions again.
|
||
The route to `HeroDetailComponent` has a twist.
|
||
|
||
回到`HeroesRoutingModule`并再次检查这些路由定义。
|
||
`HeroDetailComponent`的路由有点特殊。
|
||
|
||
|
||
<code-example path="router/src/app/heroes/heroes-routing.module.ts" linenums="false" title="src/app/heroes/heroes-routing.module.ts (excerpt)" region="hero-detail-route">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Notice the `:id` token in the path. That creates a slot in the path for a **Route Parameter**.
|
||
In this case, the router will insert the `id` of a hero into that slot.
|
||
|
||
注意路径中的`:id`令牌。它为*路由参数*在路径中创建一个“空位”。在这里，我们期待路由器把英雄的`id`插入到那个“空位”中。
|
||
|
||
If you tell the router to navigate to the detail component and display "Magneta",
|
||
you expect a hero id to appear in the browser URL like this:
|
||
|
||
如果要告诉路由器导航到详情组件，并让它显示“Magneta”，我们会期望这个英雄的`id`像这样显示在浏览器的URL中：
|
||
|
||
|
||
|
||
<code-example format="nocode">
|
||
localhost:3000/hero/15
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
If a user enters that URL into the browser address bar, the router should recognize the
|
||
pattern and go to the same "Magneta" detail view.
|
||
|
||
如果用户把此URL输入到浏览器的地址栏中，路由器就会识别出这种模式，同样进入“Magneta”的详情视图。
|
||
|
||
|
||
<div class="callout is-helpful">
|
||
|
||
|
||
|
||
<header>
|
||
Route parameter: Required or optional?
|
||
</header>
|
||
|
||
|
||
|
||
Embedding the route parameter token, `:id`,
|
||
in the route definition path is a good choice for this scenario
|
||
because the `id` is *required* by the `HeroDetailComponent` and because
|
||
the value `15` in the path clearly distinguishes the route to "Magneta" from
|
||
a route for some other hero.
|
||
|
||
在这个场景下，把路由参数的令牌`:id`嵌入到路由定义的`path`中是一个好主意，因为对于`HeroDetailComponent`来说`id`是*必须的*，
|
||
而且路径中的值`15`已经足够把到“Magneta”的路由和到其它英雄的路由明确区分开。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
{@a navigate}
|
||
|
||
|
||
### Navigate to hero detail imperatively
|
||
|
||
### 命令式地导航到英雄详情
|
||
|
||
Users *will not* navigate to the detail component by clicking a link
|
||
so you won't add a new `RouterLink` anchor tag to the shell.
|
||
|
||
*这次我们不打算通过点击链接来导航到详情组件*，因此也不用再把带`RouterLink`的新的A标签加到壳组件中。
|
||
|
||
Instead, when the user *clicks* a hero in the list, you'll ask the router
|
||
to navigate to the hero detail view for the selected hero.
|
||
|
||
而是改为当用户在列表中*点击*一个英雄时，我们将*要求*路由器导航到所选英雄的详情视图
|
||
|
||
Start in the `HeroListComponent`.
|
||
Revise its constructor so that it acquires the `Router` and the `HeroService` by dependency injection:
|
||
|
||
从`HeroListComponent`开始。
|
||
修改它的构造函数，让它通过依赖注入获得`Router`和`HeroService`：
|
||
|
||
|
||
<code-example path="router/src/app/heroes/hero-list.component.1.ts" linenums="false" title="src/app/heroes/hero-list.component.ts (constructor)" region="ctor">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Make the following few changes to the component's template:
|
||
|
||
还要对模板进行一点修改：
|
||
|
||
|
||
<code-example path="router/src/app/heroes/hero-list.component.1.ts" linenums="false" title="src/app/heroes/hero-list.component.ts (template)" region="template">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
The template defines an `*ngFor` repeater such as [you've seen before](guide/displaying-data#ngFor).
|
||
There's a `(click)` [event binding](guide/template-syntax#event-binding) to the component's
|
||
`onSelect` method which you implement as follows:
|
||
|
||
模板像[以前](guide/displaying-data#ngFor)一样定义了一个`*ngFor`重复器。
|
||
还有一个`(click)`[事件绑定](guide/template-syntax#event-binding)，绑定到了组件的`onSelect`方法，就像这样：
|
||
|
||
|
||
<code-example path="router/src/app/heroes/hero-list.component.1.ts" linenums="false" title="src/app/heroes/hero-list.component.ts (select)" region="select">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
The component's `onSelect` calls the router's **`navigate`** method with a _link parameters array_.
|
||
You can use this same syntax in a `RouterLink` if you decide later to navigate in HTML template rather than in component code.
|
||
|
||
它用一个**链接参数数组**调用路由器的**`navigate`**方法。
|
||
如果我们想把它用在HTML中，那么也可以把相同的语法用在`RouterLink`中。
|
||
|
||
|
||
|
||
{@a route-parameters}
|
||
|
||
|
||
### Setting the route parameters in the list view
|
||
|
||
### 在列表视图中设置路由参数
|
||
|
||
After navigating to the `HeroDetailComponent`, you expect to see the details of the selected hero.
|
||
You need *two* pieces of information: the routing path to the component and the hero's `id`.
|
||
|
||
我们将导航到`HeroDetailComponent`组件。在那里，我们期望看到所选英雄的详情，这需要两部分信息：导航目标和该英雄的`id`。
|
||
|
||
Accordingly, the _link parameters array_ has *two* items: the routing _path_ and a _route parameter_ that specifies the
|
||
`id` of the selected hero.
|
||
|
||
因此，这个*链接参数数组*中有两个条目：目标路由的**`path`（路径）**，和一个用来指定所选英雄`id`的**路由参数**。
|
||
|
||
|
||
<code-example path="router/src/app/heroes/hero-list.component.1.ts" linenums="false" title="src/app/heroes/hero-list.component.ts (link-parameters-array)" region="link-parameters-array">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
The router composes the destination URL from the array like this:
|
||
`localhost:3000/hero/15`.
|
||
|
||
路由器从该数组中组合出了目标URL：
|
||
`localhost:3000/hero/15`。
|
||
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
How does the target `HeroDetailComponent` learn about that `id`?
|
||
Don't analyze the URL. Let the router do it.
|
||
|
||
目标组件`HeroDetailComponent`该怎么知道这个`id`参数呢？
|
||
当然不会是自己去分析URL了！那是路由器的工作。
|
||
|
||
The router extracts the route parameter (`id:15`) from the URL and supplies it to
|
||
the `HeroDetailComponent` via the `ActivatedRoute` service.
|
||
|
||
路由器从URL中解析出路由参数（`id:15`），并通过**ActivatedRoute**服务来把它提供给`HeroDetailComponent`组件。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
{@a activated-route}
|
||
|
||
|
||
### ActivatedRoute: the one-stop-shop for route information
|
||
|
||
### ActivatedRoute：一站式获取路由信息
|
||
|
||
The route path and parameters are available through an injected router service called the
|
||
[ActivatedRoute](api/router/ActivatedRoute).
|
||
It has a great deal of useful information including:
|
||
|
||
该路由的路径和参数可以通过注入进来的一个名叫[ActivatedRoute](api/router/ActivatedRoute)的路由服务来获取。
|
||
它有一大堆有用的信息，包括：
|
||
|
||
<table>
|
||
<tr>
|
||
<th>
|
||
Property
|
||
</th>
|
||
|
||
<th>
|
||
Description
|
||
</th>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
<code>url</code>
|
||
</td>
|
||
<td>
|
||
|
||
An `Observable` of the route path(s), represented as an array of strings for each part of the route path.
|
||
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
<code>data</code>
|
||
</td>
|
||
<td>
|
||
|
||
An `Observable` that contains the `data` object provided for the route. Also contains any resolved values from the [resolve guard](#resolve-guard).
|
||
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
<code>paramMap</code>
|
||
</td>
|
||
<td>
|
||
|
||
An `Observable` that contains a [map](api/router/ParamMap) of the required and [optional parameters](#optional-route-parameters) specific to the route. The map supports retrieving single and multiple values from the same parameter.
|
||
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
<code>queryParamMap</code>
|
||
</td>
|
||
<td>
|
||
|
||
An `Observable` that contains a [map](api/router/ParamMap) of the [query parameters](#query-parameters) available to all routes.
|
||
The map supports retrieving single and multiple values from the query parameter.
|
||
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
<code>fragment</code>
|
||
</td>
|
||
<td>
|
||
|
||
An `Observable` of the URL [fragment](#fragment) available to all routes.
|
||
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
<code>outlet</code>
|
||
</td>
|
||
<td>
|
||
|
||
The name of the `RouterOutlet` used to render the route. For an unnamed outlet, the outlet name is _primary_.
|
||
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
<code>routeConfig</code>
|
||
</td>
|
||
<td>
|
||
|
||
The route configuration used for the route that contains the origin path.
|
||
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
<code>parent</code>
|
||
</td>
|
||
<td>
|
||
|
||
The route's parent `ActivatedRoute` when this route is a [child route](#child-routing-component).
|
||
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
<code>firstChild</code>
|
||
</td>
|
||
<td>
|
||
|
||
Contains the first `ActivatedRoute` in the list of this route's child routes.
|
||
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
<code>children</code>
|
||
</td>
|
||
<td>
|
||
|
||
Contains all the [child routes](#child-routing-component) activated under the current route.
|
||
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
|
||
<div class="l-sub-section">
|
||
|
||
Two older properties are still available. They are less capable than their replacements, discouraged, and may be deprecated in a future Angular version.
|
||
|
||
**`params`** — An `Observable` that contains the required and [optional parameters](#optional-route-parameters) specific to the route. Use `paramMap` instead.
|
||
|
||
**`queryParams`** — An `Observable` that contains the [query parameters](#query-parameters) available to all routes.
|
||
Use `queryParamMap` instead.
|
||
|
||
</div>
|
||
|
||
#### _Activated Route_ in action
|
||
|
||
Import the `Router`, `ActivatedRoute`, and `ParamMap` tokens from the router package.
|
||
|
||
我们要从路由器（`router`）包中导入`Router`、`ActivatedRoute`和`Params`类。
|
||
|
||
|
||
<code-example path="router/src/app/heroes/hero-detail.component.1.ts" linenums="false" title="src/app/heroes/hero-detail.component.ts (activated route)" region="imports">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Import the `switchMap` operator because you need it later to process the `Observable` route parameters.
|
||
|
||
这里导入`switchMap`操作符是因为我们稍后将会处理路由参数的可观察对象`Observable`。
|
||
|
||
|
||
<code-example path="router/src/app/heroes/hero-detail.component.ts" linenums="false" title="src/app/heroes/hero-detail.component.ts (switchMap operator import)" region="rxjs-operator-import">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
{@a hero-detail-ctor}
|
||
|
||
|
||
As usual, you write a constructor that asks Angular to inject services
|
||
that the component requires and reference them as private variables.
|
||
|
||
通常，我们会直接写一个构造函数，让Angular把组件所需的服务注入进来，自动定义同名的私有变量，并把它们存进去。
|
||
|
||
|
||
<code-example path="router/src/app/heroes/hero-detail.component.ts" linenums="false" title="src/app/heroes/hero-detail.component.ts (constructor)" region="ctor">
|
||
|
||
</code-example>
|
||
|
||
Later, in the `ngOnInit` method, you use the `ActivatedRoute` service to retrieve the parameters for the route,
|
||
pull the hero `id` from the parameters and retrieve the hero to display.
|
||
|
||
然后，在`ngOnInit`方法中，我们用`ActivatedRoute`服务来接收路由的参数，从参数中取得该英雄的`id`，并接收此英雄用于显示。
|
||
|
||
|
||
<code-example path="router/src/app/heroes/hero-detail.component.ts" linenums="false" title="src/app/heroes/hero-detail.component.ts (ngOnInit)" region="ngOnInit">
|
||
|
||
</code-example>
|
||
|
||
The `paramMap` processing is a bit tricky. When the map changes, you `get()`
|
||
the `id` parameter from the changed parameters.
|
||
|
||
Then you tell the `HeroService` to fetch the hero with that `id` and return the result of the `HeroService` request.
|
||
|
||
You might think to use the RxJS `map` operator.
|
||
But the `HeroService` returns an `Observable<Hero>`.
|
||
Your subscription wants the `Hero`, not an `Observable<Hero>`.
|
||
So you flatten the `Observable` with the `switchMap` operator instead.
|
||
|
||
由于参数是作为`Observable`提供的，所以我们得用`switchMap`操作符来根据名字取得`id`参数，并告诉`HeroService`来获取带有那个`id`的英雄。
|
||
|
||
The `switchMap` operator also cancels previous in-flight requests. If the user re-navigates to this route
|
||
with a new `id` while the `HeroService` is still retrieving the old `id`, `switchMap` discards that old request and returns the hero for the new `id`.
|
||
|
||
Finally, you activate the observable with `subscribe` method and (re)set the component's `hero` property with the retrieved hero.
|
||
|
||
#### _ParamMap_ API
|
||
|
||
The `ParamMap` API is inspired by the [URLSearchParams interface](https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams). It provides methods
|
||
to handle parameter access for both route parameters (`paramMap`) and query parameters (`queryParamMap`).
|
||
|
||
<table>
|
||
<tr>
|
||
<th>
|
||
Member
|
||
</th>
|
||
|
||
<th>
|
||
Description
|
||
</th>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
<code>has(name)</code>
|
||
</td>
|
||
<td>
|
||
|
||
Returns `true` if the parameter name is in the map of parameters.
|
||
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
<code>get(name)</code>
|
||
</td>
|
||
<td>
|
||
|
||
Returns the parameter name value (a `string`) if present, or `null` if the parameter name is not in the map. Returns the _first_ element if the parameter value is actually an array of values.
|
||
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
<code>getAll(name)</code>
|
||
</td>
|
||
<td>
|
||
|
||
Returns a `string array` of the parameter name value if found, or an empty `array` if the parameter name value is not in the map. Use `getAll` when a single parameter could have multiple values.
|
||
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
<code>keys</code>
|
||
</td>
|
||
<td>
|
||
|
||
Returns a `string array` of all parameter names in the map.
|
||
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
|
||
{@a reuse}
|
||
|
||
#### Observable <i>paramMap</i> and component reuse
|
||
|
||
#### <i>参数</i>的可观察对象（Observable）与组件复用
|
||
|
||
In this example, you retrieve the route parameter map from an `Observable`.
|
||
That implies that the route parameter map can change during the lifetime of this component.
|
||
|
||
在这个例子中，我们订阅了路由参数的`Observable`对象。
|
||
这种写法暗示着这些路由参数在该组件的生存期内可能会变化。
|
||
|
||
They might. By default, the router re-uses a component instance when it re-navigates to the same component type
|
||
without visiting a different component first. The route parameters could change each time.
|
||
|
||
确实如此！默认情况下，如果它没有访问过其它组件就导航到了同一个组件实例，那么路由器倾向于复用组件实例。如果复用，这些参数可以变化。
|
||
|
||
Suppose a parent component navigation bar had "forward" and "back" buttons
|
||
that scrolled through the list of heroes.
|
||
Each click navigated imperatively to the `HeroDetailComponent` with the next or previous `id`.
|
||
|
||
假设父组件的导航栏有“前进”和“后退”按钮，用来轮流显示英雄列表中中英雄的详情。
|
||
每次点击都会强制导航到带前一个或后一个`id`的`HeroDetailComponent`组件。
|
||
|
||
You don't want the router to remove the current `HeroDetailComponent` instance from the DOM only to re-create it for the next `id`.
|
||
That could be visibly jarring.
|
||
Better to simply re-use the same component instance and update the parameter.
|
||
|
||
我们不希望路由器仅仅从DOM中移除当前的`HeroDetailComponent`实例，并且用下一个`id`重新创建它。
|
||
那可能导致界面抖动。
|
||
更好的方式是复用同一个组件实例，并更新这些参数。
|
||
|
||
Unfortunately, `ngOnInit` is only called once per component instantiation.
|
||
You need a way to detect when the route parameters change from _within the same instance_.
|
||
The observable `paramMap` property handles that beautifully.
|
||
|
||
不幸的是，`ngOnInit`对每个实例只调用一次。
|
||
我们需要一种方式来检测_在同一个实例中_路由参数什么时候发生了变化。
|
||
而`params`属性这个可观察对象（Observable）干净漂亮的处理了这种情况。
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
When subscribing to an observable in a component, you almost always arrange to unsubscribe when the component is destroyed.
|
||
|
||
当在组件中订阅一个可观察对象时，我们通常总是要在组件销毁时取消这个订阅。
|
||
|
||
There are a few exceptional observables where this is not necessary.
|
||
The `ActivatedRoute` observables are among the exceptions.
|
||
|
||
但是也有少数例外情况不需要取消订阅。
|
||
`ActivateRoute`中的各种可观察对象就是属于这种情况。
|
||
|
||
The `ActivatedRoute` and its observables are insulated from the `Router` itself.
|
||
The `Router` destroys a routed component when it is no longer needed and the injected `ActivatedRoute` dies with it.
|
||
|
||
`ActivateRoute`及其可观察对象都是由`Router`本身负责管理的。
|
||
`Router`会在不再需要时销毁这个路由组件，而注入进去的`ActivateRoute`也随之销毁了。
|
||
|
||
Feel free to unsubscribe anyway. It is harmless and never a bad practice.
|
||
|
||
不过，我们仍然可以随意取消订阅，这不会造成任何损害，而且也不是一项坏的实践。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
{@a snapshot}
|
||
|
||
|
||
#### _Snapshot_: the _no-observable_ alternative
|
||
|
||
#### *Snapshot*（快照）：当不需要Observable时的替代品
|
||
|
||
_This_ application won't re-use the `HeroDetailComponent`.
|
||
The user always returns to the hero list to select another hero to view.
|
||
There's no way to navigate from one hero detail to another hero detail
|
||
without visiting the list component in between.
|
||
Therefore, the router creates a new `HeroDetailComponent` instance every time.
|
||
|
||
本应用不需要复用`HeroDetailComponent`。
|
||
我们总会先返回英雄列表，再选择另一位英雄。
|
||
所以，不存在从一个英雄详情导航到另一个而不用经过英雄列表的情况。
|
||
这意味着我们每次都会得到一个全新的`HeroDetailComponent`实例。
|
||
|
||
When you know for certain that a `HeroDetailComponent` instance will *never, never, ever*
|
||
be re-used, you can simplify the code with the *snapshot*.
|
||
|
||
假如我们很确定这个`HeroDetailComponent`组件的实例*永远、永远*不会被复用，那就可以使用*快照*来简化这段代码。
|
||
|
||
The `route.snapshot` provides the initial value of the route parameter map.
|
||
You can access the parameters directly without subscribing or adding observable operators.
|
||
It's much simpler to write and read:
|
||
|
||
`route.snapshot`提供了路由参数的初始值。
|
||
我们可以通过它来直接访问参数，而不用订阅或者添加Observable的操作符。
|
||
这样在读写时就会更简单：
|
||
|
||
|
||
<code-example path="router/src/app/heroes/hero-detail.component.2.ts" linenums="false" title="src/app/heroes/hero-detail.component.ts (ngOnInit snapshot)" region="snapshot">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
**Remember:** you only get the _initial_ value of the parameter map with this technique.
|
||
Stick with the observable `paramMap` approach if there's even a chance that the router
|
||
could re-use the component.
|
||
This sample stays with the observable `paramMap` strategy just in case.
|
||
|
||
**记住：**，用这种技巧，我们只得到了这些参数的_初始_值。
|
||
如果有可能连续多次导航到此组件，那么就该用`params`可观察对象的方式。
|
||
我们在这里选择使用`params`可观察对象策略，以防万一。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
{@a nav-to-list}
|
||
|
||
|
||
### Navigating back to the list component
|
||
|
||
### 导航回列表组件
|
||
|
||
The `HeroDetailComponent` has a "Back" button wired to its `gotoHeroes` method that navigates imperatively
|
||
back to the `HeroListComponent`.
|
||
|
||
`HeroDetailComponent`组件有一个“Back”按钮，关联到它的`gotoHeroes`方法，该方法会导航回`HeroListComponent`组件。
|
||
|
||
The router `navigate` method takes the same one-item _link parameters array_
|
||
that you can bind to a `[routerLink]` directive.
|
||
It holds the _path to the `HeroListComponent`_:
|
||
|
||
路由的`navigate`方法同样接受一个单条目的*链接参数数组*，我们也可以把它绑定到`[routerLink]`指令上。
|
||
它保存着**到`HeroListComponent`组件的路径**：
|
||
|
||
|
||
<code-example path="router/src/app/heroes/hero-detail.component.1.ts" linenums="false" title="src/app/heroes/hero-detail.component.ts (excerpt)" region="gotoHeroes">
|
||
|
||
</code-example>
|
||
|
||
|
||
{@a optional-route-parameters}
|
||
|
||
### Route Parameters: Required or optional?
|
||
### 路由参数：必须还是可选？
|
||
|
||
Use [*route parameters*](#route-parameters) to specify a *required* parameter value *within* the route URL
|
||
as you do when navigating to the `HeroDetailComponent` in order to view the hero with *id*15:
|
||
|
||
如果想导航到`HeroDetailComponent`以对id为15的英雄进行查看并编辑，就要在路由的URL中使用[*路由参数*](guide/router#route-parameters)来指定*必要*参数值。
|
||
|
||
|
||
<code-example format="nocode">
|
||
localhost:3000/hero/15
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
You can also add *optional* information to a route request.
|
||
For example, when returning to the heroes list from the hero detail view,
|
||
it would be nice if the viewed hero was preselected in the list.
|
||
|
||
我们也能在路由请求中添加*可选*信息。
|
||
比如，当从`HeroDetailComponent`返回英雄列表时，如果能自动选中刚刚查看过的英雄就好了。
|
||
|
||
|
||
<figure>
|
||
<img src='generated/images/guide/router/selected-hero.png' alt="Selected hero">
|
||
</figure>
|
||
|
||
|
||
|
||
You'll implement this feature in a moment by including the viewed hero's `id`
|
||
in the URL as an optional parameter when returning from the `HeroDetailComponent`.
|
||
|
||
如果我们能在从`HeroDetailComponent`返回时在URL中带上英雄Magneta的`id`，不就可以了吗？接下来我们就尝试实现这个场景。
|
||
|
||
Optional information takes other forms. Search criteria are often loosely structured, e.g., `name='wind*'`.
|
||
Multiple values are common—`after='12/31/2015' & before='1/1/2017'`—in no
|
||
particular order—`before='1/1/2017' & after='12/31/2015'`— in a
|
||
variety of formats—`during='currentYear'`.
|
||
|
||
可选信息有很多种形式。搜索条件通常就不是严格结构化的，比如`name='wind*'`；有多个值也很常见，如`after='12/31/2015'&before='1/1/2017'`；
|
||
而且顺序无关，如`before='1/1/2017'&after='12/31/2015'`，还可能有很多种变体格式，如`during='currentYear'`。
|
||
|
||
These kinds of parameters don't fit easily in a URL *path*. Even if you could define a suitable URL token scheme,
|
||
doing so greatly complicates the pattern matching required to translate an incoming URL to a named route.
|
||
|
||
这么多种参数要放在URL的*路径*中可不容易。即使我们能制定出一个合适的URL方案，实现起来也太复杂了，得通过模式匹配才能把URL翻译成命名路由。
|
||
|
||
Optional parameters are the ideal vehicle for conveying arbitrarily complex information during navigation.
|
||
Optional parameters aren't involved in pattern matching and afford flexibility of expression.
|
||
|
||
可选参数是在导航期间传送任意复杂信息的理想载体。
|
||
可选参数不涉及到模式匹配并在表达上提供了巨大的灵活性。
|
||
|
||
The router supports navigation with optional parameters as well as required route parameters.
|
||
Define _optional_ parameters in a separate object _after_ you define the required route parameters.
|
||
|
||
和必要参数一样，路由器也支持通过可选参数导航。
|
||
我们在定义完必要参数之后，通过一个*独立的对象*来定义*可选参数*。
|
||
|
||
In general, prefer a *required route parameter* when
|
||
the value is mandatory (for example, if necessary to distinguish one route path from another);
|
||
prefer an *optional parameter* when the value is optional, complex, and/or multivariate.
|
||
|
||
通常，对于强制性的值（比如用于区分两个路由路径的）使用*必备参数*；当这个值是可选的、复杂的或多值的时，使用可选参数。
|
||
|
||
|
||
{@a optionally-selecting}
|
||
|
||
|
||
### Heroes list: optionally selecting a hero
|
||
|
||
### 英雄列表：选定一个英雄（也可不选）
|
||
|
||
When navigating to the `HeroDetailComponent` you specified the _required_ `id` of the hero-to-edit in the
|
||
*route parameter* and made it the second item of the [_link parameters array_](#link-parameters-array).
|
||
|
||
当导航到`HeroDetailComponent`时，我们可以在*路由参数*中指定一个所要编辑的英雄`id`，只要把它作为[链接参数数组](guide/router#link-parameters-array)中的第二个条目就可以了。
|
||
|
||
|
||
<code-example path="router/src/app/heroes/hero-list.component.1.ts" linenums="false" title="src/app/heroes/hero-list.component.ts (link-parameters-array)" region="link-parameters-array">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
The router embedded the `id` value in the navigation URL because you had defined it
|
||
as a route parameter with an `:id` placeholder token in the route `path`:
|
||
|
||
路由器在导航URL中内嵌了`id`的值，这是因为我们把它用一个`:id`占位符当做路由参数定义在了路由的`path`中：
|
||
|
||
|
||
<code-example path="router/src/app/heroes/heroes-routing.module.ts" linenums="false" title="src/app/heroes/heroes-routing.module.ts (hero-detail-route)" region="hero-detail-route">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
When the user clicks the back button, the `HeroDetailComponent` constructs another _link parameters array_
|
||
which it uses to navigate back to the `HeroListComponent`.
|
||
|
||
当用户点击后退按钮时，`HeroDetailComponent`构造了另一个*链接参数数组*，可以用它导航回`HeroListComponent`。
|
||
|
||
|
||
<code-example path="router/src/app/heroes/hero-detail.component.1.ts" linenums="false" title="src/app/heroes/hero-detail.component.ts (gotoHeroes)" region="gotoHeroes">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
This array lacks a route parameter because you had no reason to send information to the `HeroListComponent`.
|
||
|
||
该数组缺少一个路由参数，这是因为我们那时没有理由往`HeroListComponent`发送信息。
|
||
|
||
Now you have a reason. You'd like to send the id of the current hero with the navigation request so that the
|
||
`HeroListComponent` can highlight that hero in its list.
|
||
This is a _nice-to-have_ feature; the list will display perfectly well without it.
|
||
|
||
但现在有了。我们要在导航请求中同时发送当前英雄的id，以便`HeroListComponent`可以在列表中高亮这个英雄。
|
||
这是一个*有更好，没有也无所谓*的特性，就算没有它，列表照样能显示得很完美。
|
||
|
||
Send the `id` with an object that contains an _optional_ `id` parameter.
|
||
For demonstration purposes, there's an extra junk parameter (`foo`) in the object that the `HeroListComponent` should ignore.
|
||
Here's the revised navigation statement:
|
||
|
||
我们传送一个包含*可选*`id`参数的对象。
|
||
为了演示，我们还在对象中定义了一个没用的额外参数（`foo`），`HeroListComponent`应该忽略它。
|
||
下面是修改过的导航语句：
|
||
|
||
|
||
<code-example path="router/src/app/heroes/hero-detail.component.ts" linenums="false" title="src/app/heroes/hero-detail.component.ts (go to heroes)" region="gotoHeroes">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
The application still works. Clicking "back" returns to the hero list view.
|
||
|
||
该应用仍然能工作。点击“back”按钮返回英雄列表视图。
|
||
|
||
Look at the browser address bar.
|
||
|
||
注意浏览器的地址栏。
|
||
|
||
|
||
It should look something like this, depending on where you run it:
|
||
|
||
它应该是这样的，不过也取决于你在哪里运行它：
|
||
|
||
|
||
<code-example language="bash">
|
||
localhost:3000/heroes;id=15;foo=foo
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
The `id` value appears in the URL as (`;id=15;foo=foo`), not in the URL path.
|
||
The path for the "Heroes" route doesn't have an `:id` token.
|
||
|
||
`id`的值像这样出现在URL中（`;id=15;foo=foo`），但不在URL的路径部分。
|
||
“Heroes”路由的路径部分并没有定义`:id`。
|
||
|
||
The optional route parameters are not separated by "?" and "&" as they would be in the URL query string.
|
||
They are **separated by semicolons ";"**
|
||
This is *matrix URL* notation — something you may not have seen before.
|
||
|
||
可选的路由参数没有使用“？”和“&”符号分隔，因为它们将用在URL查询字符串中。
|
||
它们是**用“;”分隔的**。
|
||
这是*矩阵URL*标记法 —— 我们以前可能从未见过。
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
*Matrix URL* notation is an idea first introduced
|
||
in a [1996 proposal](http://www.w3.org/DesignIssues/MatrixURIs.html) by the founder of the web, Tim Berners-Lee.
|
||
|
||
*Matrix URL*写法首次提出是在[1996提案](http://www.w3.org/DesignIssues/MatrixURIs.html)中，提出者是Web的奠基人：Tim Berners-Lee。
|
||
|
||
Although matrix notation never made it into the HTML standard, it is legal and
|
||
it became popular among browser routing systems as a way to isolate parameters
|
||
belonging to parent and child routes. The Router is such a system and provides
|
||
support for the matrix notation across browsers.
|
||
|
||
虽然Matrix写法未曾进入过HTML标准，但它是合法的。而且在浏览器的路由系统中，它作为从父路由和子路由中单独隔离出参数的方式而广受欢迎。Angular的路由器正是这样一个路由系统，并支持跨浏览器的Matrix写法。
|
||
|
||
The syntax may seem strange to you but users are unlikely to notice or care
|
||
as long as the URL can be emailed and pasted into a browser address bar
|
||
as this one can.
|
||
|
||
这种语法对我们来说可能有点奇怪，不过用户不会在意这一点，因为该URL可以正常的通过邮件发出去或粘贴到浏览器的地址栏中。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
{@a route-parameters-activated-route}
|
||
|
||
|
||
### Route parameters in the *ActivatedRoute* service
|
||
|
||
### *ActivatedRoute*服务中的路由参数
|
||
|
||
The list of heroes is unchanged. No hero row is highlighted.
|
||
|
||
英雄列表仍没有改变，没有哪个英雄列被加亮显示。
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
The <live-example></live-example> *does* highlight the selected
|
||
row because it demonstrates the final state of the application which includes the steps you're *about* to cover.
|
||
At the moment this guide is describing the state of affairs *prior* to those steps.
|
||
|
||
<live-example></live-example>*高亮了*选中的行，因为它演示的是应用的最终状态，因此包含了我们*即将*示范的步骤。
|
||
此刻，我们描述的仍是那些步骤*之前*的状态。
|
||
|
||
</div>
|
||
|
||
|
||
|
||
The `HeroListComponent` isn't expecting any parameters at all and wouldn't know what to do with them.
|
||
You can change that.
|
||
|
||
`HeroListComponent`还完全不需要任何参数，也不知道该怎么处理它们。我们这就改变这一点。
|
||
|
||
Previously, when navigating from the `HeroListComponent` to the `HeroDetailComponent`,
|
||
you subscribed to the route parameter map `Observable` and made it available to the `HeroDetailComponent`
|
||
in the `ActivatedRoute` service.
|
||
You injected that service in the constructor of the `HeroDetailComponent`.
|
||
|
||
以前，当从`HeroListComponent`导航到`HeroDetailComponent`时，我们通过`ActivatedRoute`服务订阅了路由参数这个`Observable`，并让它能用在`HeroDetailComponent`中。我们把该服务注入到了`HeroDetailComponent`的构造函数中。
|
||
|
||
This time you'll be navigating in the opposite direction, from the `HeroDetailComponent` to the `HeroListComponent`.
|
||
|
||
这次，我们要进行反向导航，从`HeroDetailComponent`到`HeroListComponent`。
|
||
|
||
First you extend the router import statement to include the `ActivatedRoute` service symbol:
|
||
|
||
首先，我们扩展该路由的导入语句，以包含进`ActivatedRoute`服务的类；
|
||
|
||
|
||
<code-example path="router/src/app/heroes/hero-list.component.ts" linenums="false" title="src/app/heroes/hero-list.component.ts (import)" region="import-router">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Import the `switchMap` operator to perform an operation on the `Observable` of route parameter map.
|
||
|
||
我们将导入`switchMap`操作符，在路由参数的`Observable`对象上执行操作。
|
||
|
||
|
||
<code-example path="router/src/app/heroes/hero-list.component.ts" linenums="false" title="src/app/heroes/hero-list.component.ts (rxjs imports)" region="rxjs-imports">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Then you inject the `ActivatedRoute` in the `HeroListComponent` constructor.
|
||
|
||
接着，我们注入`ActivatedRoute`到`HeroListComponent`的构造函数中。
|
||
|
||
|
||
<code-example path="router/src/app/heroes/hero-list.component.ts" linenums="false" title="src/app/heroes/hero-list.component.ts (constructor and ngOnInit)" region="ctor">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
The `ActivatedRoute.paramMap` property is an `Observable` map of route parameters. The `paramMap` emits a new map of values that includes `id`
|
||
when the user navigates to the component. In `ngOnInit` you subscribe to those values, set the `selectedId`, and get the heroes.
|
||
|
||
ActivatedRoute.paramMap属性是一个路由参数的可观察对象。当用户导航到这个组件时，paramMap会发射一个新值，其中包含`id`。
|
||
在ngOnInit中，我们订阅了这些值，设置到selectedId，并获取英雄数据。
|
||
|
||
Add an `isSelected` method that returns `true` when a hero's `id` matches the selected `id`.
|
||
|
||
我们添加了一个`isSelected`方法，当英雄的id和选中的id匹配时，它返回真值。
|
||
|
||
|
||
<code-example path="router/src/app/heroes/hero-list.component.ts" linenums="false" title="src/app/heroes/hero-list.component.ts (isSelected)" region="isSelected">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Finally, update the template with a [class binding](guide/template-syntax#class-binding) to that `isSelected` method.
|
||
The binding adds the `selected` CSS class when the method returns `true` and removes it when `false`.
|
||
Look for it within the repeated `<li>` tag as shown here:
|
||
|
||
最后，我们用[CSS类绑定](guide/template-syntax#class-binding)更新模板，把它绑定到`isSelected`方法上。
|
||
如果该方法返回`true`，此绑定就会添加CSS类`selected`，否则就移除它。
|
||
在`<li>`标记中找到它，就像这样：
|
||
|
||
|
||
<code-example path="router/src/app/heroes/hero-list.component.ts" linenums="false" title="src/app/heroes/hero-list.component.ts (template)" region="template">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
When the user navigates from the heroes list to the "Magneta" hero and back, "Magneta" appears selected:
|
||
|
||
当用户从英雄列表导航到英雄“Magneta”并返回时，“Magneta”看起来是选中的：
|
||
|
||
|
||
<figure>
|
||
<img src='generated/images/guide/router/selected-hero.png' alt="Selected List">
|
||
</figure>
|
||
|
||
|
||
|
||
The optional `foo` route parameter is harmless and continues to be ignored.
|
||
|
||
这儿可选的`foo`路由参数人畜无害，并继续被忽略。
|
||
|
||
|
||
{@a route-animation}
|
||
|
||
|
||
### Adding animations to the routed component
|
||
|
||
### 为路由组件添加动画
|
||
|
||
The heroes feature module is almost complete, but what is a feature without some smooth transitions?
|
||
|
||
这个“英雄”特性模块就要完成了，但这个特性还没有平滑的转场效果。
|
||
|
||
This section shows you how to add some [animations](guide/animations)
|
||
to the `HeroDetailComponent`.
|
||
|
||
在这一节，我们将为*英雄详情*组件添加一些[动画](guide/animations)。
|
||
|
||
First import `BrowserAnimationsModule`:
|
||
|
||
首先导入`BrowserAnimationsModule`：
|
||
|
||
|
||
<code-example path="router/src/app/app.module.ts" linenums="false" title="src/app/app.module.ts (animations-module)" region="animations-module">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Create an `animations.ts` file in the root `src/app/` folder. The contents look like this:
|
||
|
||
在根目录`src/app/`下创建一个`animations.ts`。内容如下：
|
||
|
||
|
||
<code-example path="router/src/app/animations.ts" linenums="false" title="src/app/animations.ts (excerpt)">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
This file does the following:
|
||
|
||
该文件做了如下工作：
|
||
|
||
* Imports the animation symbols that build the animation triggers, control state, and manage transitions between states.
|
||
|
||
导入动画符号以构建动画触发器、控制状态并管理状态之间的过渡。
|
||
|
||
* Exports a constant named `slideInDownAnimation` set to an animation trigger named *`routeAnimation`*;
|
||
animated components will refer to this name.
|
||
|
||
导出了一个名叫`slideInDownAnimation`的常量，并把它设置为一个名叫*`routeAnimation`的动画触发器。带动画的组件将会引用这个名字。
|
||
|
||
* Specifies the _wildcard state_ , `*`, that matches any animation state that the route component is in.
|
||
|
||
指定了一个*通配符状态* —— `*`，它匹配该路由组件存在时的任何动画状态。
|
||
|
||
* Defines two *transitions*, one to ease the component in from the left of the screen as it enters the application view (`:enter`),
|
||
the other to animate the component down as it leaves the application view (`:leave`).
|
||
|
||
定义两个*过渡效果*，其中一个（`:enter`）在组件进入应用视图时让它从屏幕左侧缓动进入（ease-in），另一个（`:leave`）在组件离开应用视图时让它向下飞出。
|
||
|
||
You could create more triggers with different transitions for other route components. This trigger is sufficient for the current milestone.
|
||
|
||
我们可以为其它路由组件用不同的转场效果创建更多触发器。现在这个触发器已经足够当前的里程碑用了。
|
||
|
||
|
||
Back in the `HeroDetailComponent`, import the `slideInDownAnimation` from `'./animations.ts`.
|
||
Add the `HostBinding` decorator to the imports from `@angular/core`; you'll need it in a moment.
|
||
|
||
返回`HeroDetailComponent`，从`'./animations.ts`中导入`slideInDownAnimation`。
|
||
从`@angular/core`中导入`HostBinding`装饰器，我们很快就会用到它。
|
||
|
||
Add an `animations` array to the `@Component` metadata's that contains the `slideInDownAnimation`.
|
||
|
||
把一个包含`slideInDownAnimation`的`animations`数组添加到`@Component`的元数据中。
|
||
|
||
Then add three `@HostBinding` properties to the class to set the animation and styles for the route component's element.
|
||
|
||
然后把三个`@HostBinding`属性添加到类中以设置这个路由组件元素的动画和样式。
|
||
|
||
|
||
<code-example path="router/src/app/heroes/hero-detail.component.ts" linenums="false" title="src/app/heroes/hero-detail.component.ts (host bindings)" region="host-bindings">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
The `'@routeAnimation'` passed to the first `@HostBinding` matches
|
||
the name of the `slideInDownAnimation` _trigger_, `routeAnimation`.
|
||
Set the `routeAnimation` property to `true` because you only care about the `:enter` and `:leave` states.
|
||
|
||
传给了第一个`@HostBinding`的`'@routeAnimation'`匹配了`slideInDownAnimation`*触发器*的名字`routeAnimation`。
|
||
把`routeAnimation`属性设置为`true`，因为我们只关心`:enter`和`:leave`这两个状态。
|
||
|
||
The other two `@HostBinding` properties style the display and position of the component.
|
||
|
||
另外两个`@HostBinding`属性指定组件的外观和位置。
|
||
|
||
The `HeroDetailComponent` will ease in from the left when routed to and will slide down when navigating away.
|
||
|
||
当进入该路由时，`HeroDetailComponent`将会从左侧缓动进入屏幕，而离开路由时，将会向下划出。
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
Applying route animations to individual components works for a simple demo, but in a real life app,
|
||
it is better to animate routes based on _route paths_.
|
||
|
||
由特性模块提供的路由将会被路由器和它们导入的模块提供的路由组合在一起。这让我们可以继续定义特性路由，而不用修改主路由配置。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
{@a milestone-3-wrap-up}
|
||
|
||
|
||
### Milestone 3 wrap up
|
||
|
||
### 里程碑#3的总结
|
||
|
||
You've learned how to do the following:
|
||
|
||
我们学到了如何：
|
||
|
||
* Organize the app into *feature areas*.
|
||
|
||
把应用组织成*特性区*
|
||
|
||
* Navigate imperatively from one component to another.
|
||
|
||
命令式的从一个组件导航到另一个
|
||
|
||
* Pass information along in route parameters and subscribe to them in the component.
|
||
|
||
通过路由参数传递信息，并在组件中订阅它们
|
||
|
||
* Import the feature area NgModule into the `AppModule`.
|
||
|
||
把这个特性分区模块导入根模块`AppModule`
|
||
|
||
* Apply animations to the route component.
|
||
|
||
把动画应用到路由组件上
|
||
|
||
After these changes, the folder structure looks like this:
|
||
|
||
做完这些修改之后，目录结构是这样的：
|
||
|
||
|
||
<div class='filetree'>
|
||
|
||
<div class='file'>
|
||
router-sample
|
||
</div>
|
||
|
||
<div class='children'>
|
||
|
||
<div class='file'>
|
||
src
|
||
</div>
|
||
|
||
<div class='children'>
|
||
|
||
<div class='file'>
|
||
app
|
||
</div>
|
||
|
||
<div class='children'>
|
||
|
||
<div class='file'>
|
||
heroes
|
||
</div>
|
||
|
||
<div class='children'>
|
||
|
||
<div class='file'>
|
||
hero-detail.component.ts
|
||
</div>
|
||
|
||
<div class='file'>
|
||
hero-list.component.ts
|
||
</div>
|
||
|
||
<div class='file'>
|
||
hero.service.ts
|
||
</div>
|
||
|
||
<div class='file'>
|
||
heroes.module.ts
|
||
</div>
|
||
|
||
<div class='file'>
|
||
heroes-routing.module.ts
|
||
</div>
|
||
|
||
</div>
|
||
|
||
<div class='file'>
|
||
app.component.ts
|
||
</div>
|
||
|
||
<div class='file'>
|
||
app.module.ts
|
||
</div>
|
||
|
||
<div class='file'>
|
||
app-routing.module.ts
|
||
</div>
|
||
|
||
<div class='file'>
|
||
crisis-list.component.ts
|
||
</div>
|
||
|
||
</div>
|
||
|
||
<div class='file'>
|
||
main.ts
|
||
</div>
|
||
|
||
<div class='file'>
|
||
index.html
|
||
</div>
|
||
|
||
<div class='file'>
|
||
styles.css
|
||
</div>
|
||
|
||
<div class='file'>
|
||
tsconfig.json
|
||
</div>
|
||
|
||
</div>
|
||
|
||
<div class='file'>
|
||
node_modules ...
|
||
</div>
|
||
|
||
<div class='file'>
|
||
package.json
|
||
</div>
|
||
|
||
</div>
|
||
|
||
</div>
|
||
|
||
Here are the relevant files for this version of the sample application.
|
||
|
||
Here are the relevant files for this version of the sample application.
|
||
|
||
这里是当前版本的范例程序相关文件。
|
||
|
||
|
||
<code-tabs>
|
||
|
||
<code-pane title="app.component.ts" path="router/src/app/app.component.1.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="app.module.ts" path="router/src/app/app.module.3.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="app-routing.module.ts" path="router/src/app/app-routing.module.2.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="hero-list.component.ts" path="router/src/app/heroes/hero-list.component.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="hero-detail.component.ts" path="router/src/app/heroes/hero-detail.component.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="hero.service.ts" path="router/src/app/heroes/hero.service.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="heroes.module.ts" path="router/src/app/heroes/heroes.module.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="heroes-routing.module.ts" path="router/src/app/heroes/heroes-routing.module.ts">
|
||
|
||
</code-pane>
|
||
|
||
</code-tabs>
|
||
|
||
|
||
|
||
{@a milestone-4}
|
||
|
||
|
||
|
||
## Milestone 4: Crisis center feature
|
||
|
||
## 里程碑#4：危机中心
|
||
|
||
It's time to add real features to the app's current placeholder crisis center.
|
||
|
||
是时候往该应用的危机中心（现在是占位符）中添加一些真实的特性了。
|
||
|
||
Begin by imitating the heroes feature:
|
||
|
||
我们先从模仿“英雄管理”中的特性开始：
|
||
|
||
* Delete the placeholder crisis center file.
|
||
|
||
删除危机中心的占位文件。
|
||
|
||
* Create an `app/crisis-center` folder.
|
||
|
||
创建`app/crisis-center`文件夹。
|
||
|
||
* Copy the files from `app/heroes` into the new crisis center folder.
|
||
|
||
把`app/heroes`中的文件复制到新的危机中心文件夹。
|
||
|
||
* In the new files, change every mention of "hero" to "crisis", and "heroes" to "crises".
|
||
|
||
在这些新文件中，把每一个对“hero”替换为“crisis”，并把“heroes”替换为“crises”。
|
||
|
||
You'll turn the `CrisisService` into a purveyor of mock crises instead of mock heroes:
|
||
|
||
我们将会把`CrisisService`转换成模拟的危机列表，而不再是模拟的英雄列表：
|
||
|
||
|
||
<code-example path="router/src/app/crisis-center/crisis.service.ts" linenums="false" title="src/app/crisis-center/crisis.service.ts (mock-crises)" region="mock-crises">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
The resulting crisis center is a foundation for introducing a new concept—**child routing**.
|
||
You can leave *Heroes* in its current state as a contrast with the *Crisis Center*
|
||
and decide later if the differences are worthwhile.
|
||
|
||
最终的危机中心可以作为引入**子路由**这个新概念的基础。
|
||
我们把*英雄管理*保持在当前状态，以便和*危机中心*进行对比，以后再根据这些差异是否有价值来决定后续行动。
|
||
|
||
|
||
<div class="alert is-helpful">
|
||
|
||
|
||
|
||
In keeping with the
|
||
<a href="https://blog.8thlight.com/uncle-bob/2014/05/08/SingleReponsibilityPrinciple.html" title="Separation of Concerns">*Separation of Concerns* principle</a>,
|
||
changes to the *Crisis Center* won't affect the `AppModule` or
|
||
any other feature's component.
|
||
|
||
遵循<a href="https://blog.8thlight.com/uncle-bob/2014/05/08/SingleReponsibilityPrinciple.html" target="_blank" title="Separation of Concerns">*关注点分离（Separation of Concerns）*原则</a>，
|
||
对*危机中心*的修改不会影响`AppModule`或其它特性模块中的组件。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
{@a crisis-child-routes}
|
||
|
||
|
||
### A crisis center with child routes
|
||
|
||
### 带有子路由的危机中心
|
||
|
||
This section shows you how to organize the crisis center
|
||
to conform to the following recommended pattern for Angular applications:
|
||
|
||
本节会展示如何组织危机中心，来满足Angular应用所推荐的模式：* Each feature area resides in its own folder. 把每个特性放在自己的目录中。
|
||
* Each feature has its own Angular feature module.
|
||
|
||
每个特性都有自己的Angular特性模块。
|
||
|
||
* Each area has its own area root component.
|
||
|
||
每个特性区都有自己的根组件。
|
||
|
||
* Each area root component has its own router outlet and child routes.
|
||
|
||
每个特性区的根组件中都有自己的路由出口及其子路由。
|
||
|
||
* Feature area routes rarely (if ever) cross with routes of other features.
|
||
|
||
特性区的路由很少（或完全不）与其它特性区的路由交叉。
|
||
|
||
If your app had many feature areas, the app component trees might look like this:
|
||
|
||
如果我们有更多特性区，它们的组件树是这样的：
|
||
|
||
|
||
<figure>
|
||
<img src='generated/images/guide/router/component-tree.png' alt="Component Tree">
|
||
</figure>
|
||
|
||
|
||
|
||
{@a child-routing-component}
|
||
|
||
|
||
### Child routing component
|
||
|
||
### 子路由组件
|
||
|
||
Add the following `crisis-center.component.ts` to the `crisis-center` folder:
|
||
|
||
|
||
往`crisis-center`目录下添加下列`crisis-center.component.ts`文件：<code-example path="router/src/app/crisis-center/crisis-center.component.ts" linenums="false" title="src/app/crisis-center/crisis-center.component.ts ">
|
||
</code-example>
|
||
|
||
The `CrisisCenterComponent` has the following in common with the `AppComponent`:
|
||
|
||
`CrisisCenterComponent`和`AppComponent`有下列共同点：
|
||
|
||
* It is the *root* of the crisis center area,
|
||
just as `AppComponent` is the root of the entire application.
|
||
|
||
它是危机中心特性区的*根*，正如`AppComponent`是整个应用的根。
|
||
|
||
* It is a *shell* for the crisis management feature area,
|
||
just as the `AppComponent` is a shell to manage the high-level workflow.
|
||
|
||
它是危机管理特性区的*壳*，正如`AppComponent`是管理高层工作流的壳。
|
||
|
||
Like most shells, the `CrisisCenterComponent` class is very simple, simpler even than `AppComponent`:
|
||
it has no business logic, and its template has no links, just a title and
|
||
`<router-outlet>` for the crisis center child views.
|
||
|
||
就像大多数的壳一样，`CrisisCenterComponent`类也非常简单，甚至比`AppComponent`更简单：
|
||
它没有业务逻辑，它的模板中没有链接，只有一个标题和用于放置危机中心的子视图的`<router-outlet>`。
|
||
|
||
Unlike `AppComponent`, and most other components, it _lacks a selector_.
|
||
It doesn't _need_ one since you don't *embed* this component in a parent template,
|
||
instead you use the router to *navigate* to it.
|
||
|
||
与`AppComponent`和大多数其它组件不同的是，它甚至都*没有指定选择器`selector`*。
|
||
它不*需要*选择器，因为我们不会把这个组件嵌入到某个父模板中，而是使用路由器*导航*到它。
|
||
|
||
|
||
{@a child-route-config}
|
||
|
||
|
||
### Child route configuration
|
||
|
||
### 子路由配置
|
||
|
||
As a host page for the "Crisis Center" feature, add the following `crisis-center-home.component.ts` to the `crisis-center` folder.
|
||
|
||
<code-example path="router/src/app/crisis-center/crisis-center-home.component.ts" linenums="false" title="src/app/crisis-center/crisis-center-home.component.ts" >
|
||
</code-example>
|
||
|
||
Create a `crisis-center-routing.module.ts` file as you did the `heroes-routing.module.ts` file.
|
||
This time, you define **child routes** *within* the parent `crisis-center` route.
|
||
|
||
像`heroes-routing.module.ts`文件一样，我们也创建一个`crisis-center-routing.module.ts`。
|
||
但这次，我们要把**子路由**定义在父路由`crisis-center`中。
|
||
|
||
|
||
<code-example path="router/src/app/crisis-center/crisis-center-routing.module.1.ts" linenums="false" title="src/app/crisis-center/crisis-center-routing.module.ts (Routes)" region="routes">
|
||
</code-example>
|
||
|
||
|
||
Notice that the parent `crisis-center` route has a `children` property
|
||
with a single route containing the `CrisisListComponent`. The `CrisisListComponent` route
|
||
also has a `children` array with two routes.
|
||
|
||
注意，父路由`crisis-center`有一个`children`属性，它有一个包含`CrisisListComponent`的路由。
|
||
`CrisisListModule`路由还有一个带两个路由的`children`数组。
|
||
|
||
These two routes navigate to the crisis center child components,
|
||
`CrisisCenterHomeComponent` and `CrisisDetailComponent`, respectively.
|
||
|
||
这两个路由导航到了*危机中心*的两个子组件：`CrisisCenterHomeComponent`和`CrisisDetailComponent`。
|
||
|
||
There are *important differences* in the way the router treats these _child routes_.
|
||
|
||
对这些路由的处理中有一些*重要的不同*。
|
||
|
||
The router displays the components of these routes in the `RouterOutlet`
|
||
of the `CrisisCenterComponent`, not in the `RouterOutlet` of the `AppComponent` shell.
|
||
|
||
路由器会把这些路由对应的组件放在`CrisisCenterComponent`的`RouterOutlet`中，而不是`AppComponent`壳组件中的。
|
||
|
||
The `CrisisListComponent` contains the crisis list and a `RouterOutlet` to
|
||
display the `Crisis Center Home` and `Crisis Detail` route components.
|
||
|
||
`CrisisListComponent`包含危机列表和一个`RouterOutlet`，用以显示`Crisis Center Home`和`Crisis Detail`这两个路由组件。
|
||
|
||
The `Crisis Detail` route is a child of the `Crisis List`. Since the router [reuses components](#reuse)
|
||
by default, the `Crisis Detail` component will be re-used as you select different crises.
|
||
|
||
`Crisis Detail`路由是`Crisis List`的子路由。由于路由器默认会[复用组件](guide/router#reuse)，因此当我们选择了另一个危机时，`CrisisDetailComponent`会被复用。
|
||
|
||
In contrast, back in the `Hero Detail` route, the component was recreated each time you selected a different hero.
|
||
|
||
作为对比，回到`Hero Detail`路由时，每当我们选择了不同的英雄时，该组件都会被重新创建。
|
||
|
||
At the top level, paths that begin with `/` refer to the root of the application.
|
||
But child routes *extend* the path of the parent route.
|
||
With each step down the route tree,
|
||
you add a slash followed by the route path, unless the path is _empty_.
|
||
|
||
在顶级，以`/`开头的路径指向的总是应用的根。
|
||
但这里是子路由。
|
||
它们是在父路由路径的基础上做出的扩展。
|
||
在路由树中每深入一步，我们就会在该路由的路径上添加一个斜线`/`（除非该路由的路径是*空的*）。
|
||
|
||
Apply that logic to navigation within the crisis center for which the parent path is `/crisis-center`.
|
||
|
||
如果把该逻辑应用到危机中心中的导航，那么父路径就是`/crisis-center`。
|
||
|
||
* To navigate to the `CrisisCenterHomeComponent`, the full URL is `/crisis-center` (`/crisis-center` + `''` + `''`).
|
||
|
||
要导航到`CrisisCenterHomeComponent`，完整的URL是`/crisis-center` (`/crisis-center` + `''` + `''`)。
|
||
|
||
* To navigate to the `CrisisDetailComponent` for a crisis with `id=2`, the full URL is
|
||
`/crisis-center/2` (`/crisis-center` + `''` + `'/2'`).
|
||
|
||
要导航到`CrisisDetailComponent`以展示`id=2`的危机，完整的URL是`/crisis-center/2` (`/crisis-center` + `''` + `'/2'`)。
|
||
|
||
The absolute URL for the latter example, including the `localhost` origin, is
|
||
|
||
本例子中包含站点部分的绝对URL，就是：
|
||
|
||
|
||
<code-example>
|
||
localhost:3000/crisis-center/2
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Here's the complete `crisis-center-routing.module.ts` file with its imports.
|
||
|
||
这里是完整的`crisis-center.routing.ts`及其导入语句。
|
||
|
||
|
||
<code-example path="router/src/app/crisis-center/crisis-center-routing.module.1.ts" linenums="false" title="src/app/crisis-center/crisis-center-routing.module.ts (excerpt)">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
{@a import-crisis-module}
|
||
|
||
|
||
### Import crisis center module into the *AppModule* routes
|
||
|
||
### 把危机中心模块导入到`AppModule`的路由中
|
||
|
||
As with the `HeroesModule`, you must add the `CrisisCenterModule` to the `imports` array of the `AppModule`
|
||
_before_ the `AppRoutingModule`:
|
||
|
||
就像`HeroesModule`模块中一样，我们必须把`CrisisCenterModule`添加到`AppModule`的`imports`数组中，就在`AppRoutingModule`前面：
|
||
|
||
|
||
<code-example path="router/src/app/app.module.4.ts" linenums="false" title="src/app/app.module.ts (import CrisisCenterModule)" region="crisis-center-module">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Remove the initial crisis center route from the `app-routing.module.ts`.
|
||
The feature routes are now provided by the `HeroesModule` and the `CrisisCenter` modules.
|
||
|
||
我们还从`app.routing.ts`中移除了危机中心的初始路由。我们的路由现在是由`HeroesModule`和`CrisisCenter`特性模块提供的。
|
||
|
||
The `app-routing.module.ts` file retains the top-level application routes such as the default and wildcard routes.
|
||
|
||
我们将保持`app.routing.ts`文件中只有通用路由，本章稍后会讲解它。
|
||
|
||
|
||
<code-example path="router/src/app/app-routing.module.3.ts" linenums="false" title="src/app/app-routing.module.ts (v3)" region="v3">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
|
||
{@a relative-navigation}
|
||
|
||
|
||
### Relative navigation
|
||
|
||
### 相对导航
|
||
|
||
While building out the crisis center feature, you navigated to the
|
||
crisis detail route using an **absolute path** that begins with a _slash_.
|
||
|
||
虽然构建出了危机中心特性区，我们却仍在使用以斜杠开头的**绝对路径**来导航到危机详情的路由。
|
||
|
||
The router matches such _absolute_ paths to routes starting from the top of the route configuration.
|
||
|
||
路由器会从路由配置的顶层来匹配像这样的*绝对路径*。
|
||
|
||
You could continue to use absolute paths like this to navigate inside the *Crisis Center*
|
||
feature, but that pins the links to the parent routing structure.
|
||
If you changed the parent `/crisis-center` path, you would have to change the link parameters array.
|
||
|
||
我们固然可以继续像*危机中心*特性区一样使用绝对路径，但是那样会把链接钉死在特定的父路由结构上。
|
||
如果我们修改了父路径`/crisis-center`，那就不得不修改每一个链接参数数组。
|
||
|
||
You can free the links from this dependency by defining paths that are **relative** to the current URL segment.
|
||
Navigation _within_ the feature area remains intact even if you change the parent route path to the feature.
|
||
|
||
通过改成定义*相对于*当前URL的路径，我们可以把链接从这种依赖中解放出来。
|
||
当我们修改了该特性区的父路由路径时，该特性区*内部*的导航仍然完好无损。
|
||
|
||
Here's an example:
|
||
|
||
例子如下：
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
The router supports directory-like syntax in a _link parameters list_ to help guide route name lookup:
|
||
|
||
在*链接参数数组*中，路由器支持“目录式”语法来指导我们如何查询路由名：
|
||
|
||
`./` or `no leading slash` is relative to the current level.
|
||
|
||
`./`或`无前导斜线`形式是相对于当前级别的。
|
||
|
||
`../` to go up one level in the route path.
|
||
|
||
`../`会回到当前路由路径的上一级。
|
||
|
||
You can combine relative navigation syntax with an ancestor path.
|
||
If you must navigate to a sibling route, you could use the `../<sibling>` convention to go up
|
||
one level, then over and down the sibling route path.
|
||
|
||
我们可以把相对导航语法和一个祖先路径组合起来用。
|
||
如果不得不导航到一个兄弟路由，我们可以用`../<sibling>`来回到上一级，然后进入兄弟路由路径中。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
To navigate a relative path with the `Router.navigate` method, you must supply the `ActivatedRoute`
|
||
to give the router knowledge of where you are in the current route tree.
|
||
|
||
用`Router.navigate`方法导航到相对路径时，我们必须提供当前的`ActivatedRoute`，来让路由器知道我们现在位于路由树中的什么位置。
|
||
|
||
After the _link parameters array_, add an object with a `relativeTo` property set to the `ActivatedRoute`.
|
||
The router then calculates the target URL based on the active route's location.
|
||
|
||
在*链接参数数组*中，添加一个带有`relativeTo`属性的对象，并把它设置为当前的`ActivatedRoute`。
|
||
这样路由器就会基于当前激活路由的位置来计算出目标URL。
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
**Always** specify the complete _absolute_ path when calling router's `navigateByUrl` method.
|
||
|
||
当调用路由器的`navigateByUrl`时，**总是**要指定完整的*绝对路径*。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
{@a nav-to-crisis}
|
||
|
||
|
||
### Navigate to crisis detail with a relative URL
|
||
|
||
### 用相对URL导航到危机详情
|
||
|
||
Update the *Crisis List* `onSelect` method to use relative navigation so you don't have
|
||
to start from the top of the route configuration.
|
||
|
||
把*危机列表*的`onSelect`方法改成使用相对导航，以便我们不用每次都从路由配置的顶层开始。
|
||
|
||
You've already injected the `ActivatedRoute` that you need to compose the relative navigation path.
|
||
|
||
我们已经注入过了`ActivatedRoute`，我们需要它来和相对导航路径组合在一起。
|
||
|
||
|
||
<code-example path="router/src/app/crisis-center/crisis-list.component.ts" linenums="false" title="src/app/crisis-center/crisis-list.component.ts (constructor)" region="ctor">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
When you visit the *Crisis Center*, the ancestor path is `/crisis-center`,
|
||
so you only need to add the `id` of the *Crisis Center* to the existing path.
|
||
|
||
当访问*危机中心*时，其祖先路径是`/crisis-center`，所以我们只需要把*危机*的`id`添加到现有路径中就可以了。
|
||
|
||
|
||
<code-example path="router/src/app/crisis-center/crisis-list.component.ts" linenums="false" title="src/app/crisis-center/crisis-list.component.ts (relative navigation)" region="onSelect">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
If you were using a `RouterLink` to navigate instead of the `Router` service, you'd use the _same_
|
||
link parameters array, but you wouldn't provide the object with the `relativeTo` property.
|
||
The `ActivatedRoute` is implicit in a `RouterLink` directive.
|
||
|
||
如果我们用`RouterLink`来代替`Router`服务进行导航，就要使用*相同*的链接参数数组，不过不再需要提供`relativeTo`属性。
|
||
`ActivatedRoute`已经隐含在了`RouterLink`指令中。
|
||
|
||
|
||
<code-example path="router/src/app/crisis-center/crisis-list.component.1.ts" linenums="false" title="src/app/crisis-center/crisis-list.component.ts (relative routerLink)" region="relative-navigation-router-link">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Update the `gotoCrises` method of the `CrisisDetailComponent` to navigate back to the *Crisis Center* list using relative path navigation.
|
||
|
||
修改`CrisisDetailComponent`的`gotoCrises`方法，来使用相对路径返回*危机中心*列表。
|
||
|
||
|
||
<code-example path="router/src/app/crisis-center/crisis-detail.component.ts" linenums="false" title="src/app/crisis-center/crisis-detail.component.ts (relative navigation)" region="gotoCrises-navigate">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Notice that the path goes up a level using the `../` syntax.
|
||
If the current crisis `id` is `3`, the resulting path back to the crisis list is `/crisis-center/;id=3;foo=foo`.
|
||
|
||
注意这个路径使用了`../`语法返回上一级。
|
||
如果当前危机的`id`是`3`，那么最终返回到的路径就是`/crisis-center/;id=3;foo=foo`。
|
||
|
||
|
||
{@a named-outlets}
|
||
|
||
|
||
|
||
### Displaying multiple routes in named outlets
|
||
|
||
### 用命名出口（outlet）显示多重路由
|
||
|
||
You decide to give users a way to contact the crisis center.
|
||
When a user clicks a "Contact" button, you want to display a message in a popup view.
|
||
|
||
我们决定给用户提供一种方式来联系危机中心。
|
||
当用户点击“Contact”按钮时，我们要在一个弹出框中显示一条消息。
|
||
|
||
The popup should stay open, even when switching between pages in the application, until the user closes it
|
||
by sending the message or canceling.
|
||
Clearly you can't put the popup in the same outlet as the other pages.
|
||
|
||
即使在应用中的不同页面之间切换，这个弹出框也应该始终保持打开状态，直到用户发送了消息或者手动取消。
|
||
显然，我们不能把这个弹出框跟其它放到页面放到同一个路由出口中。
|
||
|
||
Until now, you've defined a single outlet and you've nested child routes
|
||
under that outlet to group routes together.
|
||
The router only supports one primary _unnamed_ outlet per template.
|
||
|
||
迄今为止，我们只定义过单路由出口，并且在其中嵌套了子路由以便对路由分组。
|
||
在每个模板中，路由器只能支持一个*无名*主路由出口。
|
||
|
||
A template can also have any number of _named_ outlets.
|
||
Each named outlet has its own set of routes with their own components.
|
||
Multiple outlets can be displaying different content, determined by different routes, all at the same time.
|
||
|
||
模板还可以有多个*命名的*路由出口。
|
||
每个命名出口都自己有一组带组件的路由。
|
||
多重出口可以在同一时间根据不同的路由来显示不同的内容。
|
||
|
||
Add an outlet named "popup" in the `AppComponent`, directly below the unnamed outlet.
|
||
|
||
在`AppComponent`中添加一个名叫“popup”的出口，就在无名出口的下方。
|
||
|
||
|
||
<code-example path="router/src/app/app.component.4.ts" linenums="false" title="src/app/app.component.ts (outlets)" region="outlets">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
That's where a popup will go, once you learn how to route a popup component to it.
|
||
|
||
一旦我们学会了如何把一个弹出框组件路由到该出口，那里就是将会出现弹出框的地方。
|
||
|
||
|
||
{@a secondary-routes}
|
||
|
||
|
||
#### Secondary routes
|
||
|
||
#### 第二路由
|
||
|
||
Named outlets are the targets of _secondary routes_.
|
||
|
||
命名出口是*第二路由*的目标。
|
||
|
||
Secondary routes look like primary routes and you configure them the same way.
|
||
They differ in a few key respects.
|
||
|
||
第二路由很像主路由，配置方式也一样。它们只有一些关键的不同点：
|
||
|
||
* They are independent of each other.
|
||
它们彼此互不依赖。* They work in combination with other routes. 它们与其它路由组合使用。
|
||
* They are displayed in named outlets.
|
||
|
||
它们显示在命名出口中。
|
||
|
||
Create a new component named `ComposeMessageComponent` in `src/app/compose-message.component.ts`.
|
||
It displays a simple form with a header, an input box for the message,
|
||
and two buttons, "Send" and "Cancel".
|
||
|
||
在`src/app/compose-message.component.ts`中创建一个名叫`ComposeMessageComponent`的新组件。
|
||
它显示一个简单的表单，包括一个头、一个消息输入框和两个按钮：“Send”和“Cancel”。
|
||
|
||
|
||
<figure>
|
||
<img src='generated/images/guide/router/contact-popup.png' alt="Contact popup">
|
||
</figure>
|
||
|
||
|
||
|
||
Here's the component and its template:
|
||
|
||
下面是该组件及其模板：
|
||
|
||
|
||
<code-tabs>
|
||
|
||
<code-pane title="src/app/compose-message.component.ts" path="router/src/app/compose-message.component.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="src/app/compose-message.component.html" path="router/src/app/compose-message.component.html">
|
||
|
||
</code-pane>
|
||
|
||
</code-tabs>
|
||
|
||
|
||
|
||
It looks about the same as any other component you've seen in this guide.
|
||
There are two noteworthy differences.
|
||
|
||
它看起来几乎和我们以前看到的其它组件一样，但有两个值得注意的区别。
|
||
|
||
Note that the `send()` method simulates latency by waiting a second before "sending" the message and closing the popup.
|
||
|
||
主要`send()`方法在发送消息和关闭弹出框之前通过等待模拟了一秒钟的延迟。
|
||
|
||
The `closePopup()` method closes the popup view by navigating to the popup outlet with a `null`.
|
||
That's a peculiarity covered [below](#clear-secondary-routes).
|
||
|
||
`closePopup()`方法用把`popup`出口导航到`null`的方式关闭了弹出框。
|
||
这个奇怪的用法在[稍后的部分](guide/router#clear-secondary-routes)有讲解。
|
||
|
||
As with other application components, you add the `ComposeMessageComponent` to the `declarations` of an `NgModule`.
|
||
Do so in the `AppModule`.
|
||
|
||
像其它组件一样，我们还要把`ComposeMessageComponent`添加到`AppModule`的`declarations`中。
|
||
|
||
|
||
{@a add-secondary-route}
|
||
|
||
|
||
#### Add a secondary route
|
||
|
||
#### 添加第二路由
|
||
|
||
Open the `AppRoutingModule` and add a new `compose` route to the `appRoutes`.
|
||
|
||
打开`AppRoutingModule`，并把一个新的`compose`路由添加到`appRoutes`中。
|
||
|
||
|
||
<code-example path="router/src/app/app-routing.module.3.ts" linenums="false" title="src/app/app-routing.module.ts (compose route)" region="compose">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
The `path` and `component` properties should be familiar.
|
||
There's a new property, `outlet`, set to `'popup'`.
|
||
This route now targets the popup outlet and the `ComposeMessageComponent` will display there.
|
||
|
||
对`path`和`component`属性应该很熟悉了吧。
|
||
注意这个新的属性`outlet`被设置成了`'popup'`。
|
||
这个路由现在指向了`popup`出口，而`ComposeMessageComponent`也将显示在那里。
|
||
|
||
The user needs a way to open the popup.
|
||
Open the `AppComponent` and add a "Contact" link.
|
||
|
||
用户需要某种途径来打开这个弹出框。
|
||
打开`AppComponent`，并添加一个“Contact”链接。
|
||
|
||
|
||
<code-example path="router/src/app/app.component.4.ts" linenums="false" title="src/app/app.component.ts (contact-link)" region="contact-link">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Although the `compose` route is pinned to the "popup" outlet, that's not sufficient for wiring the route to a `RouterLink` directive.
|
||
You have to specify the named outlet in a _link parameters array_ and bind it to the `RouterLink` with a property binding.
|
||
|
||
虽然`compose`路由被钉死在了`popup`出口上，但这仍然不足以向`RouterLink`指令表明要加载该路由。
|
||
我们还要在*链接参数数组*中指定这个命名出口，并通过属性绑定的形式把它绑定到`RouterLink`上。
|
||
|
||
The _link parameters array_ contains an object with a single `outlets` property whose value
|
||
is another object keyed by one (or more) outlet names.
|
||
In this case there is only the "popup" outlet property and its value is another _link parameters array_ that specifies the `compose` route.
|
||
|
||
*链接参数数组*包含一个只有一个`outlets`属性的对象，它的值是另一个对象，这个对象以一个或多个路由的出口名作为属性名。
|
||
在这里，它只有一个出口名“popup”，它的值则是另一个*链接参数数组*，用于指定`compose`路由。
|
||
|
||
You are in effect saying, _when the user clicks this link, display the component associated with the `compose` route in the `popup` outlet_.
|
||
|
||
意思是，当用户点击此链接时，在路由出口`popup`中显示与`compose`路由相关联的组件。
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
This `outlets` object within an outer object was completely unnecessary
|
||
when there was only one route and one _unnamed_ outlet to think about.
|
||
|
||
当有且只有一个*无名*出口时，外部对象中的这个`outlets`对象并不是必须的。
|
||
|
||
The router assumed that your route specification targeted the _unnamed_ primary outlet
|
||
and created these objects for you.
|
||
|
||
路由器假设这个路由指向了*无名*的主出口，并为我们创建这些对象。
|
||
|
||
Routing to a named outlet has revealed a previously hidden router truth:
|
||
you can target multiple outlets with multiple routes in the same `RouterLink` directive.
|
||
|
||
当路由到一个命名出口时，我们就会发现一个以前被隐藏的真相：
|
||
我们可以在同一个`RouterLink`指令中为多个路由出口指定多个路由。
|
||
|
||
You're not actually doing that here.
|
||
But to target a named outlet, you must use the richer, more verbose syntax.
|
||
|
||
这里我们实际上没能这样做。要想指向命名出口，我们就得使用一种更强大也更啰嗦的语法。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
{@a secondary-route-navigation}
|
||
|
||
|
||
#### Secondary route navigation: merging routes during navigation
|
||
|
||
#### 第二路由导航：在导航期间合并路由
|
||
|
||
Navigate to the _Crisis Center_ and click "Contact".
|
||
you should see something like the following URL in the browser address bar.
|
||
|
||
导航到*危机中心*并点击“Contact”，我们将会在浏览器的地址栏看到如下URL：
|
||
|
||
|
||
<code-example>
|
||
http://.../crisis-center(popup:compose)
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
The interesting part of the URL follows the `...`:
|
||
|
||
这个URL中有意思的部分是`...`后面的这些：* The `crisis-center` is the primary navigation. `crisis-center`是主导航。
|
||
* Parentheses surround the secondary route.
|
||
|
||
圆括号包裹的部分是第二路由。
|
||
|
||
* The secondary route consists of an outlet name (`popup`), a `colon` separator, and the secondary route path (`compose`).
|
||
|
||
第二路由包括一个出口名称（`popup`）、一个冒号分隔符和第二路由的路径（`compose`）。
|
||
|
||
Click the _Heroes_ link and look at the URL again.
|
||
|
||
点击*Heroes*链接，并再次查看URL：
|
||
|
||
|
||
<code-example>
|
||
http://.../heroes(popup:compose)
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
The primary navigation part has changed; the secondary route is the same.
|
||
|
||
主导航的部分变化了，而第二路由没有变。
|
||
|
||
The router is keeping track of two separate branches in a navigation tree and generating a representation of that tree in the URL.
|
||
|
||
路由器在导航树中对两个独立的分支保持追踪，并在URL中对这棵树进行表达。
|
||
|
||
You can add many more outlets and routes, at the top level and in nested levels, creating a navigation tree with many branches.
|
||
The router will generate the URL to go with it.
|
||
|
||
我们还可以添加更多出口和更多路由（无论是在顶层还是在嵌套的子层）来创建一个带有多个分支的导航树。
|
||
路由器将会生成相应的URL。
|
||
|
||
You can tell the router to navigate an entire tree at once by filling out the `outlets` object mentioned above.
|
||
Then pass that object inside a _link parameters array_ to the `router.navigate` method.
|
||
|
||
通过像前面那样填充`outlets`对象，我们可以告诉路由器立即导航到一棵完整的树。
|
||
然后把这个对象通过一个*链接参数数组*传给`router.navigate`方法。
|
||
|
||
Experiment with these possibilities at your leisure.
|
||
|
||
|
||
有空的时候你可以自行试验这些可能性。
|
||
|
||
|
||
{@a clear-secondary-routes}
|
||
|
||
|
||
#### Clearing secondary routes
|
||
|
||
#### 清除第二路由
|
||
|
||
As you've learned, a component in an outlet persists until you navigate away to a new component.
|
||
Secondary outlets are no different in this regard.
|
||
|
||
正如我们刚刚学到的，除非导航到新的组件，否则路由出口中的组件会始终存在。
|
||
这里涉及到的第二出口也同样如此。
|
||
|
||
Each secondary outlet has its own navigation, independent of the navigation driving the primary outlet.
|
||
Changing a current route that displays in the primary outlet has no effect on the popup outlet.
|
||
That's why the popup stays visible as you navigate among the crises and heroes.
|
||
|
||
每个第二出口都有自己独立的导航，跟主出口的导航彼此独立。
|
||
修改主出口中的当前路由并不会影响到`popup`出口中的。
|
||
这就是为什么在危机中心和英雄管理之间导航时，弹出框始终都是可见的。
|
||
|
||
Clicking the "send" or "cancel" buttons _does_ clear the popup view.
|
||
To see how, look at the `closePopup()` method again:
|
||
|
||
点击“send”或“cancel”按钮，则*会*清除弹出框视图。
|
||
为何如此？我们再来看看`closePopup()`方法：
|
||
|
||
|
||
<code-example path="router/src/app/compose-message.component.ts" linenums="false" title="src/app/compose-message.component.ts (closePopup)" region="closePopup">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
It navigates imperatively with the `Router.navigate()` method, passing in a [link parameters array](#link-parameters-array).
|
||
|
||
它使用`Router.navigate()`方法进行强制导航，并传入了一个[链接参数数组](guide/router#link-parameters-array)。
|
||
|
||
Like the array bound to the _Contact_ `RouterLink` in the `AppComponent`,
|
||
this one includes an object with an `outlets` property.
|
||
The `outlets` property value is another object with outlet names for keys.
|
||
The only named outlet is `'popup'`.
|
||
|
||
就像在`AppComponent`中绑定到的*Contact* `RouterLink`一样，它也包含了一个带`outlets`属性的对象。
|
||
`outlets`属性的值是另一个对象，该对象用一些出口名称作为属性名。
|
||
唯一的命名出口是`'popup'`。
|
||
|
||
This time, the value of `'popup'` is `null`. That's not a route, but it is a legitimate value.
|
||
Setting the popup `RouterOutlet` to `null` clears the outlet and removes
|
||
the secondary popup route from the current URL.
|
||
|
||
但这次，`'popup'`的值是`null`。`null`不是一个路由，但却是一个合法的值。
|
||
把`popup`这个`RouterOutlet`设置为`null`会清除该出口，并且从当前URL中移除第二路由`popup`。
|
||
|
||
{@a guards}
|
||
|
||
## Milestone 5: Route guards
|
||
|
||
## 里程碑5：路由守卫
|
||
|
||
|
||
At the moment, *any* user can navigate *anywhere* in the application *anytime*.
|
||
That's not always the right thing to do.
|
||
|
||
现在，*任何用户*都能在*任何时候*导航到*任何地方*。
|
||
但有时候这样是不对的。
|
||
|
||
* Perhaps the user is not authorized to navigate to the target component.
|
||
|
||
该用户可能无权导航到目标组件。
|
||
|
||
* Maybe the user must login (*authenticate*) first.
|
||
|
||
可能用户得先登录（认证）。
|
||
|
||
* Maybe you should fetch some data before you display the target component.
|
||
|
||
在显示目标组件前，我们可能得先获取某些数据。
|
||
|
||
* You might want to save pending changes before leaving a component.
|
||
|
||
在离开组件前，我们可能要先保存修改。
|
||
|
||
* You might ask the user if it's OK to discard pending changes rather than save them.
|
||
|
||
我们可能要询问用户：你是否要放弃本次更改，而不用保存它们？
|
||
|
||
You can add _guards_ to the route configuration to handle these scenarios.
|
||
|
||
我们可以往路由配置中添加***守卫***，来处理这些场景。
|
||
|
||
A guard's return value controls the router's behavior:
|
||
|
||
守卫返回一个值，以控制路由器的行为：
|
||
|
||
* If it returns `true`, the navigation process continues.
|
||
|
||
如果它返回`true`，导航过程会继续
|
||
|
||
* If it returns `false`, the navigation process stops and the user stays put.
|
||
|
||
如果它返回`false`，导航过程会终止，且用户会留在原地。
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
The guard can also tell the router to navigate elsewhere, effectively canceling the current navigation.
|
||
|
||
守卫还可以告诉路由器导航到别处，这样也取消当前的导航。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
The guard *might* return its boolean answer synchronously.
|
||
But in many cases, the guard can't produce an answer synchronously.
|
||
The guard could ask the user a question, save changes to the server, or fetch fresh data.
|
||
These are all asynchronous operations.
|
||
|
||
守卫*可以*用同步的方式返回一个布尔值。但在很多情况下，守卫无法用同步的方式给出答案。
|
||
守卫可能会向用户问一个问题、把更改保存到服务器，或者获取新数据，而这些都是异步操作。
|
||
|
||
Accordingly, a routing guard can return an `Observable<boolean>` or a `Promise<boolean>` and the
|
||
router will wait for the observable to resolve to `true` or `false`.
|
||
|
||
因此，路由的守卫可以返回一个`Observable<boolean>`或`Promise<boolean>`，并且路由器会等待这个可观察对象被解析为`true`或`false`。
|
||
|
||
The router supports multiple guard interfaces:
|
||
|
||
* [`CanActivate`](api/router/CanActivate) to mediate navigation *to* a route.
|
||
|
||
用[`CanActivate`](api/router/CanActivate)来处理导航*到*某路由的情况。
|
||
|
||
* [`CanActivateChild`](api/router/CanActivateChild) to mediate navigation *to* a child route.
|
||
|
||
用[`CanActivateChild`](api/router/CanActivateChild)来处理导航*到*某子路由的情况。
|
||
|
||
* [`CanDeactivate`](api/router/CanDeactivate) to mediate navigation *away* from the current route.
|
||
|
||
用[`CanDeactivate`](api/router/CanDeactivate)来处理从当前路由*离开*的情况.
|
||
|
||
* [`Resolve`](api/router/Resolve) to perform route data retrieval *before* route activation.
|
||
|
||
用[`Resolve`](api/router/Resolve)在路由激活*之前*获取路由数据。
|
||
|
||
* [`CanLoad`](api/router/CanLoad) to mediate navigation *to* a feature module loaded _asynchronously_.
|
||
|
||
用[`CanLoad`](api/router/CanLoad)来处理*异步*导航到某特性模块的情况。
|
||
|
||
|
||
You can have multiple guards at every level of a routing hierarchy.
|
||
The router checks the `CanDeactivate` and `CanActivateChild` guards first, from the deepest child route to the top.
|
||
Then it checks the `CanActivate` guards from the top down to the deepest child route. If the feature module
|
||
is loaded asynchronously, the `CanLoad` guard is checked before the module is loaded.
|
||
If _any_ guard returns false, pending guards that have not completed will be canceled,
|
||
and the entire navigation is canceled.
|
||
|
||
在分层路由的每个级别上，我们都可以设置多个守卫。
|
||
路由器会先按照从最深的子路由由下往上检查的顺序来检查`CanDeactivate()`和`CanActivateChild()`守卫。
|
||
然后它会按照从上到下的顺序检查`CanActivate()`和`CanActivateChild()`守卫。
|
||
如果特性模块是异步加载的，在加载它之前还会检查`CanLoad()`守卫。
|
||
如果*任何*一个守卫返回`false`，其它尚未完成的守卫会被取消，这样整个导航就被取消了。
|
||
|
||
There are several examples over the next few sections.
|
||
|
||
我们会在接下来的小节中看到一些例子。
|
||
|
||
|
||
{@a can-activate-guard}
|
||
|
||
|
||
### _CanActivate_: requiring authentication
|
||
|
||
### *CanActivate*: 要求认证
|
||
|
||
Applications often restrict access to a feature area based on who the user is.
|
||
You could permit access only to authenticated users or to users with a specific role.
|
||
You might block or limit access until the user's account is activated.
|
||
|
||
应用程序通常会根据访问者来决定是否授予某个特性区的访问权。
|
||
我们可以只对已认证过的用户或具有特定角色的用户授予访问权，还可以阻止或限制用户访问权，直到用户账户激活为止。
|
||
|
||
The `CanActivate` guard is the tool to manage these navigation business rules.
|
||
|
||
`CanActivate`守卫是一个管理这些导航类业务规则的工具。
|
||
|
||
#### Add an admin feature module
|
||
|
||
#### 添加一个“管理”特性模块
|
||
|
||
|
||
In this next section, you'll extend the crisis center with some new *administrative* features.
|
||
Those features aren't defined yet.
|
||
But you can start by adding a new feature module named `AdminModule`.
|
||
|
||
在下一节，我们将会使用一些新的*管理*特性来扩展危机中心。
|
||
那些特性尚未定义，但是我们可以先从添加一个名叫`AdminModule`的特性模块开始。
|
||
|
||
Create an `admin` folder with a feature module file, a routing configuration file, and supporting components.
|
||
|
||
创建一个`admin`目录，它带有一个特性模块文件、一个路由配置文件和一些支持性组件。
|
||
|
||
The admin feature file structure looks like this:
|
||
|
||
管理特性区的文件是这样的：
|
||
|
||
|
||
<div class='filetree'>
|
||
|
||
<div class='file'>
|
||
src/app/admin
|
||
</div>
|
||
|
||
<div class='children'>
|
||
|
||
<div class='file'>
|
||
admin-dashboard.component.ts
|
||
</div>
|
||
|
||
<div class='file'>
|
||
admin.component.ts
|
||
</div>
|
||
|
||
<div class='file'>
|
||
admin.module.ts
|
||
</div>
|
||
|
||
<div class='file'>
|
||
admin-routing.module.ts
|
||
</div>
|
||
|
||
<div class='file'>
|
||
manage-crises.component.ts
|
||
</div>
|
||
|
||
<div class='file'>
|
||
manage-heroes.component.ts
|
||
</div>
|
||
|
||
</div>
|
||
|
||
</div>
|
||
|
||
|
||
|
||
The admin feature module contains the `AdminComponent` used for routing within the
|
||
feature module, a dashboard route and two unfinished components to manage crises and heroes.
|
||
|
||
管理特性模块包含`AdminComponent`，它用于在特性模块内的仪表盘路由以及两个尚未完成的用于管理危机和英雄的组件之间进行路由。
|
||
|
||
|
||
<code-tabs>
|
||
|
||
<code-pane title="src/app/admin/admin-dashboard.component.ts" path="router/src/app/admin/admin-dashboard.component.1.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="src/app/admin/admin.component.ts" path="router/src/app/admin/admin.component.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="src/app/admin/admin.module.ts" path="router/src/app/admin/admin.module.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="src/app/admin/manage-crises.component.ts" path="router/src/app/admin/manage-crises.component.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="src/app/admin/manage-heroes.component.ts" path="router/src/app/admin/manage-heroes.component.ts">
|
||
|
||
</code-pane>
|
||
|
||
</code-tabs>
|
||
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
Since the admin dashboard `RouterLink` is an empty path route in the `AdminComponent`, it
|
||
is considered a match to any route within the admin feature area.
|
||
You only want the `Dashboard` link to be active when the user visits that route.
|
||
Adding an additional binding to the `Dashboard` routerLink,
|
||
`[routerLinkActiveOptions]="{ exact: true }"`, marks the `./` link as active when
|
||
the user navigates to the `/admin` URL and not when navigating to any of the child routes.
|
||
|
||
由于`AdminModule`中`AdminComponent`中的`RouterLink`是一个空路径的路由，所以它会匹配到管理特性区的任何路由。
|
||
但我们只有在访问`Dashboard`路由时才希望该链接被激活。
|
||
所以我们往`Dashboard`这个routerLink上添加了另一个绑定`[routerLinkActiveOptions]="{ exact: true }"`，
|
||
这样就只有当我们导航到`/admin`这个URL时才会激活它，而不会在导航到它的某个子路由时。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
The initial admin routing configuration:
|
||
|
||
我们的初始管理路由配置如下：
|
||
|
||
|
||
<code-example path="router/src/app/admin/admin-routing.module.1.ts" linenums="false" title="src/app/admin/admin-routing.module.ts (admin routing)" region="admin-routes">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
{@a component-less-route}
|
||
|
||
|
||
### Component-less route: grouping routes without a component
|
||
|
||
### 无组件路由: 不借助组件对路由进行分组
|
||
|
||
Looking at the child route under the `AdminComponent`, there is a `path` and a `children`
|
||
property but it's not using a `component`.
|
||
You haven't made a mistake in the configuration.
|
||
You've defined a _component-less_ route.
|
||
|
||
来看`AdminComponent`下的子路由，我们有一个带**path**和**children**的子路由，
|
||
但它没有使用**component**。这并不是配置中的失误，而是在使用**无组件**路由。
|
||
|
||
The goal is to group the `Crisis Center` management routes under the `admin` path.
|
||
You don't need a component to do it.
|
||
A _component-less_ route makes it easier to [guard child routes](#can-activate-child-guard).
|
||
|
||
我们的目标是对`admin`路径下的`危机中心`管理类路由进行分组，但并不需要另一个仅用来分组路由的组件。
|
||
一个*无组件*的路由就能让我们轻松的[守卫子路由](guide/router#can-activate-child-guard)。
|
||
|
||
|
||
Next, import the `AdminModule` into `app.module.ts` and add it to the `imports` array
|
||
to register the admin routes.
|
||
|
||
接下来，我们把`AdminModule`导入到`app.module.ts`中，并把它加入`imports`数组中来注册这些管理类路由。
|
||
|
||
|
||
<code-example path="router/src/app/app.module.4.ts" linenums="false" title="src/app/app.module.ts (admin module)" region="admin-module">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Add an "Admin" link to the `AppComponent` shell so that users can get to this feature.
|
||
|
||
然后我们往壳组件`AppComponent`中添加一个链接，让用户能点击它，以访问该特性。
|
||
|
||
|
||
<code-example path="router/src/app/app.component.5.ts" linenums="false" title="src/app/app.component.ts (template)" region="template">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
{@a guard-admin-feature}
|
||
|
||
|
||
#### Guard the admin feature
|
||
|
||
#### 守护“管理特性”区
|
||
|
||
Currently every route within the *Crisis Center* is open to everyone.
|
||
The new *admin* feature should be accessible only to authenticated users.
|
||
|
||
现在“危机中心”的每个路由都是对所有人开放的。这些新的*管理特性*应该只能被已登录用户访问。
|
||
|
||
You could hide the link until the user logs in. But that's tricky and difficult to maintain.
|
||
|
||
我们可以在用户登录之前隐藏这些链接，但这样会有点复杂并难以维护。
|
||
|
||
Instead you'll write a `canActivate()` guard method to redirect anonymous users to the
|
||
login page when they try to enter the admin area.
|
||
|
||
我们换种方式：写一个`CanActivate()`守卫，当匿名用户尝试访问管理组件时，把它/她重定向到登录页。
|
||
|
||
This is a general purpose guard—you can imagine other features
|
||
that require authenticated users—so you create an
|
||
`auth-guard.service.ts` in the application root folder.
|
||
|
||
这是一种具有通用性的守护目标（通常会有其它特性需要登录用户才能访问），所以我们在应用的根目录下创建一个`auth-guard.ts`文件。
|
||
|
||
At the moment you're interested in seeing how guards work so the first version does nothing useful.
|
||
It simply logs to console and `returns` true immediately, allowing navigation to proceed:
|
||
|
||
此刻，我们的兴趣在于看看守卫是如何工作的，所以我们第一个版本没做什么有用的事情。它只是往控制台写日志，并且立即返回`true`，让导航继续：
|
||
|
||
|
||
<code-example path="router/src/app/auth-guard.service.1.ts" linenums="false" title="src/app/auth-guard.service.ts (excerpt)">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Next, open `admin-routing.module.ts `, import the `AuthGuard` class, and
|
||
update the admin route with a `canActivate` guard property that references it:
|
||
|
||
接下来，打开`crisis-center.routes.ts`，导入`AuthGuard`类，修改管理路由并通过`CanActivate()`守卫来引用`AuthGuard`：
|
||
|
||
|
||
<code-example path="router/src/app/admin/admin-routing.module.2.ts" linenums="false" title="src/app/admin/admin-routing.module.ts (guarded admin route)" region="admin-route">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
The admin feature is now protected by the guard, albeit protected poorly.
|
||
|
||
我们的管理特性区现在受此守卫保护了，不过这样的保护还不够。
|
||
|
||
|
||
{@a teach-auth}
|
||
|
||
|
||
#### Teach *AuthGuard* to authenticate
|
||
|
||
#### 教*AuthGuard*进行认证
|
||
|
||
Make the `AuthGuard` at least pretend to authenticate.
|
||
|
||
我们先让`AuthGuard`至少能“假装”进行认证。
|
||
|
||
The `AuthGuard` should call an application service that can login a user and retain information about the current user.
|
||
Here's a demo `AuthService`:
|
||
|
||
`AuthGuard`可以调用应用中的一项服务，该服务能让用户登录，并且保存当前用户的信息。下面是一个`AuthService`的示范：
|
||
|
||
|
||
<code-example path="router/src/app/auth.service.ts" linenums="false" title="src/app/auth.service.ts (excerpt)">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Although it doesn't actually log in, it has what you need for this discussion.
|
||
It has an `isLoggedIn` flag to tell you whether the user is authenticated.
|
||
Its `login` method simulates an API call to an external service by returning an
|
||
Observable that resolves successfully after a short pause.
|
||
The `redirectUrl` property will store the attempted URL so you can navigate to it after authenticating.
|
||
|
||
虽然它不会真的进行登录，但足够让我们进行这个讨论了。
|
||
它有一个`isLoggedIn`标志，用来标识是否用户已经登录过了。
|
||
它的`login`方法会仿真一个对外部服务的API调用，返回一个可观察对象（observable）。在短暂的停顿之后，这个可观察对象就会解析成功。
|
||
`redirectUrl`属性将会保存在URL中，以便认证完之后导航到它。
|
||
|
||
Revise the `AuthGuard` to call it.
|
||
|
||
我们这就修改`AuthGuard`来调用它。
|
||
|
||
|
||
<code-example path="router/src/app/auth-guard.service.2.ts" linenums="false" title="src/app/auth-guard.service.ts (v2)">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Notice that you *inject* the `AuthService` and the `Router` in the constructor.
|
||
You haven't provided the `AuthService` yet but it's good to know that you can inject helpful services into routing guards.
|
||
|
||
注意，我们把`AuthService`和`Router`服务*注入到*构造函数中。
|
||
我们还没有提供`AuthService`，这里要说明的是：可以往路由守卫中注入有用的服务。
|
||
|
||
This guard returns a synchronous boolean result.
|
||
If the user is logged in, it returns true and the navigation continues.
|
||
|
||
该守卫返回一个同步的布尔值。如果用户已经登录，它就返回`true`，导航会继续。
|
||
|
||
The `ActivatedRouteSnapshot` contains the _future_ route that will be activated and the `RouterStateSnapshot`
|
||
contains the _future_ `RouterState` of the application, should you pass through the guard check.
|
||
|
||
这个`ActivatedRouteSnapshot`包含了_即将_被激活的路由，而`RouterStateSnapshot`包含了该应用_即将_到达的状态。
|
||
它们要通过我们的守卫进行检查。
|
||
|
||
If the user is not logged in, you store the attempted URL the user came from using the `RouterStateSnapshot.url` and
|
||
tell the router to navigate to a login page—a page you haven't created yet.
|
||
This secondary navigation automatically cancels the current navigation; `checkLogin()` returns
|
||
`false` just to be clear about that.
|
||
|
||
如果用户还没有登录，我们会用`RouterStateSnapshot.url`保存用户来自的URL并让路由器导航到登录页（我们尚未创建该页）。
|
||
这间接导致路由器自动中止了这次导航，`checkLogin()`返回`false`并不是必须的，但这样可以更清楚的表达意图。
|
||
|
||
|
||
{@a add-login-component}
|
||
|
||
|
||
#### Add the *LoginComponent*
|
||
|
||
#### 添加*LoginComponent*
|
||
|
||
You need a `LoginComponent` for the user to log in to the app. After logging in, you'll redirect
|
||
to the stored URL if available, or use the default URL.
|
||
There is nothing new about this component or the way you wire it into the router configuration.
|
||
|
||
我们需要一个`LoginComponent`来让用户登录进这个应用。在登录之后，我们跳转到前面保存的URL，如果没有，就跳转到默认URL。
|
||
该组件没有什么新内容，我们把它放进路由配置的方式也没什么新意。
|
||
|
||
Register a `/login` route in the `login-routing.module.ts` and add the necessary providers to the `providers`
|
||
array. In `app.module.ts`, import the `LoginComponent` and add it to the `AppModule` `declarations`.
|
||
Import and add the `LoginRoutingModule` to the `AppModule` imports as well.
|
||
|
||
我们将在`login-routing.module.ts`中注册一个`/login`路由，并把必要的提供商添加`providers`数组中。
|
||
在`app.module.ts`中，我们导入`LoginComponent`并把它加入根模块的`declarations`中。
|
||
同时在`AppModule`中导入并添加`LoginRoutingModule`。
|
||
|
||
|
||
<code-tabs>
|
||
|
||
<code-pane title="src/app/app.module.ts" path="router/src/app/app.module.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="src/app/login.component.ts" path="router/src/app/login.component.1.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="src/app/login-routing.module.ts" path="router/src/app/login-routing.module.ts">
|
||
|
||
</code-pane>
|
||
|
||
</code-tabs>
|
||
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
Guards and the service providers they require _must_ be provided at the module-level. This allows
|
||
the Router access to retrieve these services from the `Injector` during the navigation process.
|
||
The same rule applies for feature modules loaded [asynchronously](#asynchronous-routing).
|
||
|
||
它们所需的守卫和服务提供商**必须**在模块一级提供。这让路由器在导航过程中可以通过`Injector`来取得这些服务。
|
||
同样的规则也适用于[异步加载](guide/router#asynchronous-routing)的特性模块。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
{@a can-activate-child-guard}
|
||
|
||
|
||
### _CanActivateChild_: guarding child routes
|
||
|
||
### `CanAcitvateChild`：保护子路由
|
||
|
||
You can also protect child routes with the `CanActivateChild` guard.
|
||
The `CanActivateChild` guard is similar to the `CanActivate` guard.
|
||
The key difference is that it runs _before_ any child route is activated.
|
||
|
||
我们还可以使用`CanActivateChild`守卫来保护子路由。
|
||
`CanActivateChild`守卫和`CanAcitvate`守卫很像。
|
||
它们的区别在于，`CanActivateChild`会在*任何子路由*被激活之前运行。
|
||
|
||
You protected the admin feature module from unauthorized access.
|
||
You should also protect child routes _within_ the feature module.
|
||
|
||
我们要保护管理特性模块，防止它被非授权访问，还要保护这个特性模块*内部*的那些子路由。
|
||
|
||
Extend the `AuthGuard` to protect when navigating between the `admin` routes.
|
||
Open `auth-guard.service.ts` and add the `CanActivateChild` interface to the imported tokens from the router package.
|
||
|
||
扩展`AuthGuard`以便在`admin`路由之间导航时提供保护。
|
||
打开`auth-guard.service.ts`并从路由库中导入`CanActivateChild`接口。
|
||
|
||
Next, implement the `canActivateChild()` method which takes the same arguments as the `canActivate()` method:
|
||
an `ActivatedRouteSnapshot` and `RouterStateSnapshot`.
|
||
The `canActivateChild()` method can return an `Observable<boolean>` or `Promise<boolean>` for
|
||
async checks and a `boolean` for sync checks.
|
||
This one returns a `boolean`:
|
||
|
||
接下来，实现`CanAcitvateChild`方法，它所接收的参数与`CanAcitvate`方法一样：一个`ActivatedRouteSnapshot`和一个`RouterStateSnapshot`。
|
||
`CanAcitvateChild`方法可以返回`Observable<boolean>`或`Promise<boolean>`来支持异步检查，或`boolean`来支持同步检查。
|
||
这里返回的是`boolean`：
|
||
|
||
|
||
<code-example path="router/src/app/auth-guard.service.3.ts" linenums="false" title="src/app/auth-guard.service.ts (excerpt)" region="can-activate-child">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Add the same `AuthGuard` to the `component-less` admin route to protect all other child routes at one time
|
||
instead of adding the `AuthGuard` to each route individually.
|
||
|
||
同样把这个`AuthGuard`添加到“无组件的”管理路由，来同时保护它的所有子路由，而不是为每个路由单独添加这个`AuthGuard`。
|
||
|
||
|
||
<code-example path="router/src/app/admin/admin-routing.module.3.ts" linenums="false" title="src/app/admin/admin-routing.module.ts (excerpt)" region="can-activate-child">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
{@a can-deactivate-guard}
|
||
|
||
|
||
### _CanDeactivate_: handling unsaved changes
|
||
|
||
### *CanDeactivate*：处理未保存的更改
|
||
|
||
Back in the "Heroes" workflow, the app accepts every change to a hero immediately without hesitation or validation.
|
||
|
||
回到“Heroes”工作流，该应用毫不犹豫的接受对英雄的任何修改，不作任何校验。
|
||
|
||
In the real world, you might have to accumulate the users changes.
|
||
You might have to validate across fields.
|
||
You might have to validate on the server.
|
||
You might have to hold changes in a pending state until the user confirms them *as a group* or
|
||
cancels and reverts all changes.
|
||
|
||
在现实世界中，我们得先把用户的改动积累起来。
|
||
我们可能不得不进行跨字段的校验，可能要找服务器进行校验，可能得把这些改动保存成一种待定状态，直到用户或者把这些改动*作为一组*进行确认或撤销所有改动。
|
||
|
||
What do you do about unapproved, unsaved changes when the user navigates away?
|
||
You can't just leave and risk losing the user's changes; that would be a terrible experience.
|
||
|
||
当用户要导航到外面时，该怎么处理这些既没有审核通过又没有保存过的改动呢？
|
||
我们不能马上离开，不在乎丢失这些改动的风险，那显然是一种糟糕的用户体验。
|
||
|
||
It's better to pause and let the user decide what to do.
|
||
If the user cancels, you'll stay put and allow more changes.
|
||
If the user approves, the app can save.
|
||
|
||
我们应该暂停，并让用户决定该怎么做。如果用户选择了取消，我们就留下来，并允许更多改动。如果用户选择了确认，那就进行保存。
|
||
|
||
You still might delay navigation until the save succeeds.
|
||
If you let the user move to the next screen immediately and
|
||
the save were to fail (perhaps the data are ruled invalid), you would lose the context of the error.
|
||
|
||
在保存成功之前，我们还可以继续推迟导航。如果我们让用户立即移到下一个界面，而保存却失败了（可能因为数据不符合有效性规则），我们就会丢失该错误的上下文环境。
|
||
|
||
You can't block while waiting for the server—that's not possible in a browser.
|
||
You need to stop the navigation while you wait, asynchronously, for the server
|
||
to return with its answer.
|
||
|
||
在等待服务器的答复时，我们没法阻塞它 —— 这在浏览器中是不可能的。
|
||
我们只能用异步的方式在等待服务器答复之前先停止导航。
|
||
|
||
You need the `CanDeactivate` guard.
|
||
|
||
我们需要`CanDeactivate`守卫。
|
||
|
||
|
||
{@a cancel-save}
|
||
|
||
|
||
### Cancel and save
|
||
|
||
The sample application doesn't talk to a server.
|
||
Fortunately, you have another way to demonstrate an asynchronous router hook.
|
||
|
||
我们的范例应用不会与服务器通讯。
|
||
幸运的是，我们有另一种方式来演示异步的路由器钩子。
|
||
|
||
Users update crisis information in the `CrisisDetailComponent`.
|
||
Unlike the `HeroDetailComponent`, the user changes do not update the crisis entity immediately.
|
||
Instead, the app updates the entity when the user presses the *Save* button and
|
||
discards the changes when the user presses the *Cancel* button.
|
||
|
||
用户在`CrisisDetailComponent`中更新危机信息。
|
||
与`HeroDetailComponent`不同，用户的改动不会立即更新危机的实体对象。当用户按下了*Save*按钮时，我们就更新这个实体对象；如果按了*Cancel*按钮，那就放弃这些更改。
|
||
|
||
Both buttons navigate back to the crisis list after save or cancel.
|
||
|
||
这两个按钮都会在保存或取消之后导航回危机列表。
|
||
|
||
|
||
<code-example path="router/src/app/crisis-center/crisis-detail.component.ts" linenums="false" title="src/app/crisis-center/crisis-detail.component.ts (cancel and save methods)" region="cancel-save">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
What if the user tries to navigate away without saving or canceling?
|
||
The user could push the browser back button or click the heroes link.
|
||
Both actions trigger a navigation.
|
||
Should the app save or cancel automatically?
|
||
|
||
如果用户尝试不保存或撤销就导航到外面该怎么办？
|
||
用户可以按浏览器的后退按钮，或点击英雄的链接。
|
||
这些操作都会触发导航。本应用应该自动保存或取消吗？
|
||
|
||
This demo does neither. Instead, it asks the user to make that choice explicitly
|
||
in a confirmation dialog box that *waits asynchronously for the user's
|
||
answer*.
|
||
|
||
都不行。我们应该弹出一个确认对话框来要求用户明确做出选择，该对话框会*用异步的方式等用户做出选择*。
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
You could wait for the user's answer with synchronous, blocking code.
|
||
The app will be more responsive—and can do other work—by
|
||
waiting for the user's answer asynchronously. Waiting for the user asynchronously
|
||
is like waiting for the server asynchronously.
|
||
|
||
我们也能用同步的方式等用户的答复，阻塞代码。但如果能用异步的方式等待用户的答复，应用就会响应性更好，也能同时做别的事。异步等待用户的答复和等待服务器的答复是类似的。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
The `DialogService`, provided in the `AppModule` for app-wide use, does the asking.
|
||
|
||
`DialogService`（为了在应用级使用，已经注入到了`AppModule`）就可以做到这些。
|
||
|
||
It returns a [promise](http://exploringjs.com/es6/ch_promises.html) that
|
||
*resolves* when the user eventually decides what to do: either
|
||
to discard changes and navigate away (`true`) or to preserve the pending changes and stay in the crisis editor (`false`).
|
||
|
||
它返回[promise](http://exploringjs.com/es6/ch_promises.html)，当用户最终决定了如何去做时，它就会被*解析* —— 或者决定放弃更改直接导航离开（`true`），或者保留未完成的修改，留在危机编辑器中（`false`）。
|
||
|
||
|
||
{@a CanDeactivate}
|
||
|
||
|
||
Create a _guard_ that checks for the presence of a `canDeactivate()` method in a component—any component.
|
||
The `CrisisDetailComponent` will have this method.
|
||
But the guard doesn't have to know that.
|
||
The guard shouldn't know the details of any component's deactivation method.
|
||
It need only detect that the component has a `canDeactivate()` method and call it.
|
||
This approach makes the guard reusable.
|
||
|
||
我们创建了一个`Guard`，它将检查这个组件中`canDeactivate`函数的工作现场，在这里，它就是`CrisisDetailComponent`。我们并不需要知道`CrisisDetailComponent`确认退出激活状态的详情。这让我们的守卫可以被复用，这是一次轻而易举的胜利。
|
||
|
||
|
||
<code-example path="router/src/app/can-deactivate-guard.service.ts" title="src/app/can-deactivate-guard.service.ts">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Alternatively, you could make a component-specific `CanDeactivate` guard for the `CrisisDetailComponent`.
|
||
The `canDeactivate()` method provides you with the current
|
||
instance of the `component`, the current `ActivatedRoute`,
|
||
and `RouterStateSnapshot` in case you needed to access
|
||
some external information. This would be useful if you only
|
||
wanted to use this guard for this component and needed to get
|
||
the component's properties or confirm whether the router should allow navigation away from it.
|
||
|
||
另外，我们也可以为`CrisisDetailComponent`创建一个特定的`CanDeactivate`守卫。在需要访问外部信息时，`canDeactivate()`方法为提供了组件、`ActivatedRoute`和`RouterStateSnapshot`的当前实例。如果只想为这个组件使用该守卫，并且需要使用该组件属性、或者需要路由器确认是否允许从该组件导航出去时，这个守卫就非常有用。
|
||
|
||
|
||
<code-example path="router/src/app/can-deactivate-guard.service.1.ts" linenums="false" title="src/app/can-deactivate-guard.service.ts (component-specific)">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Looking back at the `CrisisDetailComponent`, it implements the confirmation workflow for unsaved changes.
|
||
|
||
看看`CrisisDetailComponent`组件，我们已经实现了对未保存的更改进行确认的工作流。
|
||
|
||
|
||
<code-example path="router/src/app/crisis-center/crisis-detail.component.ts" linenums="false" title="src/app/crisis-center/crisis-detail.component.ts (excerpt)" region="canDeactivate">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Notice that the `canDeactivate()` method *can* return synchronously;
|
||
it returns `true` immediately if there is no crisis or there are no pending changes.
|
||
But it can also return a `Promise` or an `Observable` and the router will wait for that
|
||
to resolve to truthy (navigate) or falsy (stay put).
|
||
|
||
注意，`canDeactivate`方法*可以*同步返回，如果没有危机，或者没有未定的修改，它就立即返回`true`。但是它也可以返回一个承诺（`Promise`）或可观察对象（`Observable`），路由器将等待它们被解析为真值（继续导航）或假值（留下）。
|
||
|
||
|
||
Add the `Guard` to the crisis detail route in `crisis-center-routing.module.ts` using the `canDeactivate` array property.
|
||
|
||
我们往`crisis-center.routing.ts`的危机详情路由中用`canDeactivate`数组添加一个`Guard`（守卫）。
|
||
|
||
|
||
<code-example path="router/src/app/crisis-center/crisis-center-routing.module.3.ts" linenums="false" title="src/app/crisis-center/crisis-center-routing.module.ts (can deactivate guard)">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Add the `Guard` to the main `AppRoutingModule` `providers` array so the
|
||
`Router` can inject it during the navigation process.
|
||
|
||
我们还要把这个`Guard`添加到`appRoutingModule`的`providers`中去，以便`Router`可以在导航过程中注入它。
|
||
|
||
|
||
<code-example path="router/src/app/app-routing.module.4.ts">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Now you have given the user a safeguard against unsaved changes.
|
||
|
||
现在，我们已经给了用户一个能保护未保存更改的安全守卫。
|
||
{@a Resolve}
|
||
|
||
{@a resolve-guard}
|
||
|
||
|
||
### _Resolve_: pre-fetching component data
|
||
|
||
### _Resolve_: 预先获取组件数据
|
||
|
||
In the `Hero Detail` and `Crisis Detail`, the app waited until the route was activated to fetch the respective hero or crisis.
|
||
|
||
在`Hero Detail`和`Crisis Detail`中，它们等待路由读取完对应的英雄和危机。
|
||
|
||
This worked well, but there's a better way.
|
||
If you were using a real world API, there might be some delay before the data to display is returned from the server.
|
||
You don't want to display a blank component while waiting for the data.
|
||
|
||
这种方式没有问题，但是它们还有进步的空间。
|
||
如果我们在使用真实api，很有可能数据返回有延迟，导致无法即时显示。
|
||
在这种情况下，直到数据到达前，显示一个空的组件不是最好的用户体验。
|
||
|
||
It's preferable to pre-fetch data from the server so it's ready the
|
||
moment the route is activated. This also allows you to handle errors before routing to the component.
|
||
There's no point in navigating to a crisis detail for an `id` that doesn't have a record.
|
||
It'd be better to send the user back to the `Crisis List` that shows only valid crisis centers.
|
||
|
||
我们最好预先从服务器上获取完数据，这样在路由激活的那一刻数据就准备好了。
|
||
还要在路由到此组件之前处理好错误。
|
||
但当某个`id`无法对应到一个危机详情时，我们没办法处理它。
|
||
这时我们最好把用户带回到“危机列表”中，那里显示了所有有效的“危机”。
|
||
|
||
In summary, you want to delay rendering the routed component until all necessary data have been fetched.
|
||
|
||
总之，你希望的是只有当所有必要数据都已经拿到之后，才渲染这个路由组件。
|
||
|
||
You need a *resolver*.
|
||
|
||
我们需要`Resolve`守卫。
|
||
|
||
|
||
{@a fetch-before-navigating}
|
||
|
||
|
||
### Fetch data before navigating
|
||
|
||
### 导航前预先加载路由信息
|
||
|
||
At the moment, the `CrisisDetailComponent` retrieves the selected crisis.
|
||
If the crisis is not found, it navigates back to the crisis list view.
|
||
|
||
目前，`CrisisDetailComponent`会接收选中的危机。
|
||
如果该危机没有找到，它就会导航回危机列表视图。
|
||
|
||
The experience might be better if all of this were handled first, before the route is activated.
|
||
A `CrisisDetailResolver` service could retrieve a `Crisis` or navigate away if the `Crisis` does not exist
|
||
_before_ activating the route and creating the `CrisisDetailComponent`.
|
||
|
||
如果能在该路由将要激活时提前处理了这个问题，那么用户体验会更好。
|
||
`CrisisDetailResolver`服务可以接收一个`Crisis`，而如果这个`Crisis`不存在，就会在激活该路由并创建`CrisisDetailComponent`之前先行离开。
|
||
|
||
Create the `crisis-detail-resolver.service.ts` file within the `Crisis Center` feature area.
|
||
|
||
在“危机中心”特性区中创建`crisis-detail-resolver.service.ts`文件。
|
||
|
||
|
||
<code-example path="router/src/app/crisis-center/crisis-detail-resolver.service.ts" title="src/app/crisis-center/crisis-detail-resolver.service.ts">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Take the relevant parts of the crisis retrieval logic in `CrisisDetailComponent.ngOnInit`
|
||
and move them into the `CrisisDetailResolver`.
|
||
Import the `Crisis` model, `CrisisService`, and the `Router`
|
||
so you can navigate elsewhere if you can't fetch the crisis.
|
||
|
||
在`CrisisDetailComponent.ngOnInit`中拿到相关的危机检索逻辑，并且把它们移到`CrisisDetailResolver`中。
|
||
导入`Crisis`模型、`CrisisService`和`Router`以便让我们可以在找不到指定的危机时导航到别处。
|
||
|
||
Be explicit. Implement the `Resolve` interface with a type of `Crisis`.
|
||
|
||
为了更明确一点，可以实现一个带有`Crisis`类型的`Resolve`接口。
|
||
|
||
Inject the `CrisisService` and `Router` and implement the `resolve()` method.
|
||
That method could return a `Promise`, an `Observable`, or a synchronous return value.
|
||
|
||
注入`CrisisService`和`Router`，并实现`resolve()`方法。
|
||
该方法可以返回一个`Promise`、一个`Observable`来支持异步方式，或者直接返回一个值来支持同步方式。
|
||
|
||
The `CrisisService.getCrisis` method returns a promise.
|
||
Return that promise to prevent the route from loading until the data is fetched.
|
||
If it doesn't return a valid `Crisis`, navigate the user back to the `CrisisListComponent`,
|
||
canceling the previous in-flight navigation to the `CrisisDetailComponent`.
|
||
|
||
`CrisisService.getCrisis`方法返回了一个`Promise`。
|
||
返回`Promise`可以阻止路由被加载，直到数据获取完毕。
|
||
如果它没有返回一个有效的`Crisis`，就把用户导航回`CrisisListComponent`，并取消以前到`CrisisDetailComponent`尚未完成的导航。
|
||
|
||
Import this resolver in the `crisis-center-routing.module.ts`
|
||
and add a `resolve` object to the `CrisisDetailComponent` route configuration.
|
||
|
||
把这个解析器（resolver）导入到`crisis-center-routing.module.ts`中，并往`CrisisDetailComponent`的路由配置中添加一个`resolve`对象。
|
||
|
||
Remember to add the `CrisisDetailResolver` service to the `CrisisCenterRoutingModule`'s `providers` array.
|
||
|
||
别忘了把`CrisisDetailResolver`服务添加到`CrisisCenterRoutingModule`的`providers`数组中。
|
||
|
||
|
||
<code-example path="router/src/app/crisis-center/crisis-center-routing.module.4.ts" linenums="false" title="src/app/crisis-center/crisis-center-routing.module.ts (resolver)" region="crisis-detail-resolver">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
The `CrisisDetailComponent` should no longer fetch the crisis.
|
||
Update the `CrisisDetailComponent` to get the crisis from the `ActivatedRoute.data.crisis` property instead;
|
||
that's where you said it should be when you re-configured the route.
|
||
It will be there when the `CrisisDetailComponent` ask for it.
|
||
|
||
`CrisisDetailComponent`不应该再去获取这个危机的详情。
|
||
把`CrisisDetailComponent`改成从`ActivatedRoute.data.crisis`属性中获取危机详情，这正是我们重新配置路由的恰当时机。
|
||
当`CrisisDetailComponent`要求取得危机详情时，它就已经在那里了。
|
||
|
||
|
||
<code-example path="router/src/app/crisis-center/crisis-detail.component.ts" linenums="false" title="src/app/crisis-center/crisis-detail.component.ts (ngOnInit v2)" region="ngOnInit">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
**Two critical points**
|
||
|
||
**两个关键点**
|
||
|
||
1. The router's `Resolve` interface is optional.
|
||
The `CrisisDetailResolver` doesn't inherit from a base class.
|
||
The router looks for that method and calls it if found.
|
||
|
||
路由器的这个`Resolve`接口是可选的。`CrisisDetailResolver`没有继承自某个基类。路由器只要找到了这个方法，就会调用它。
|
||
|
||
1. Rely on the router to call the resolver.
|
||
Don't worry about all the ways that the user could navigate away.
|
||
That's the router's job. Write this class and let the router take it from there.
|
||
|
||
我们依赖路由器调用此守卫。不必关心用户用哪种方式导航离开，这是路由器的工作。我们只要写出这个类，等路由器从那里取出它就可以了。
|
||
|
||
The relevant *Crisis Center* code for this milestone follows.
|
||
|
||
本里程碑中与*危机中心*有关的代码如下：
|
||
|
||
|
||
<code-tabs>
|
||
|
||
<code-pane title="app.component.ts" path="router/src/app/app.component.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="crisis-center-home.component.ts" path="router/src/app/crisis-center/crisis-center-home.component.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="crisis-center.component.ts" path="router/src/app/crisis-center/crisis-center.component.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="crisis-center-routing.module.ts" path="router/src/app/crisis-center/crisis-center-routing.module.4.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="crisis-list.component.ts" path="router/src/app/crisis-center/crisis-list.component.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="crisis-detail.component.ts" path="router/src/app/crisis-center/crisis-detail.component.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="crisis-detail-resolver.service.ts" path="router/src/app/crisis-center/crisis-detail-resolver.service.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="crisis.service.ts" path="router/src/app/crisis-center/crisis.service.ts">
|
||
|
||
</code-pane>
|
||
|
||
</code-tabs>
|
||
|
||
|
||
|
||
<code-tabs>
|
||
|
||
<code-pane title="auth-guard.service.ts" path="router/src/app/auth-guard.service.3.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="can-deactivate-guard.service.ts" path="router/src/app/can-deactivate-guard.service.ts">
|
||
|
||
</code-pane>
|
||
|
||
</code-tabs>
|
||
|
||
|
||
|
||
{@a query-parameters}
|
||
|
||
|
||
{@a fragment}
|
||
|
||
|
||
### Query parameters and fragments
|
||
|
||
### 查询参数及片段
|
||
|
||
In the [route parameters](#optional-route-parameters) example, you only dealt with parameters specific to
|
||
the route, but what if you wanted optional parameters available to all routes?
|
||
This is where query parameters come into play.
|
||
|
||
在这个[查询参数](guide/router#query-parameters)例子中，我们只为路由指定了参数，但是该如何定义一些所有路由中都可用的可选参数呢？
|
||
这就该“查询参数”登场了。
|
||
|
||
[Fragments](https://en.wikipedia.org/wiki/Fragment_identifier) refer to certain elements on the page
|
||
identified with an `id` attribute.
|
||
|
||
[片段](https://en.wikipedia.org/wiki/Fragment_identifier)可以引用页面中带有特定`id`属性的元素.
|
||
|
||
Update the `AuthGuard` to provide a `session_id` query that will remain after navigating to another route.
|
||
|
||
接下来，我们将更新`AuthGuard`来提供`session_id`查询参数，在导航到其它路由后，它还会存在。
|
||
|
||
Add an `anchor` element so you can jump to a certain point on the page.
|
||
|
||
再添加一个锚点（`A`）元素，来让你能跳转到页面中的正确位置。
|
||
|
||
Add the `NavigationExtras` object to the `router.navigate` method that navigates you to the `/login` route.
|
||
|
||
我们还将为`router.nativate`方法传入一个`NavigationExtras`对象，用来导航到`/login`路由。
|
||
|
||
|
||
<code-example path="router/src/app/auth-guard.service.4.ts" linenums="false" title="src/app/auth-guard.service.ts (v3)">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
You can also preserve query parameters and fragments across navigations without having to provide them
|
||
again when navigating. In the `LoginComponent`, you'll add an *object* as the
|
||
second argument in the `router.navigate` function
|
||
and provide the `queryParamsHandling` and `preserveFragment` to pass along the current query parameters
|
||
and fragment to the next route.
|
||
|
||
还可以再导航之间**保留**查询参数和片段，而无需再次再导航中提供。在`LoginComponent`中的`router.navigate`方法中，添加第二个参数，该**对象**提供了`preserveQueryParams`和 `preserveFragment`，用于传递到当前的查询参数中并为下一个路由提供片段。
|
||
|
||
|
||
<code-example path="router/src/app/login.component.ts" linenums="false" title="src/app/login.component.ts (preserve)" region="preserve">
|
||
|
||
</code-example>
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
The `queryParamsHandling` feature also provides a `merge` option, which will preserve and combine the current query parameters with any provided query parameters
|
||
when navigating.
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
Since you'll be navigating to the *Admin Dashboard* route after logging in, you'll update it to handle the
|
||
query parameters and fragment.
|
||
|
||
由于要在登录后导航到*危机管理*特征区的路由，所以我们还得更新它，来处理这些全局查询参数和片段。
|
||
|
||
|
||
<code-example path="router/src/app/admin/admin-dashboard.component.2.ts" linenums="false" title="src/app/admin/admin-dashboard.component.ts (v2)">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
*Query parameters* and *fragments* are also available through the `ActivatedRoute` service.
|
||
Just like *route parameters*, the query parameters and fragments are provided as an `Observable`.
|
||
The updated *Crisis Admin* component feeds the `Observable` directly into the template using the `AsyncPipe`.
|
||
|
||
*查询参数*和*片段*可通过`Router`服务的`routerState`属性使用。和*路由参数*类似，全局查询参数和片段也是`Observable`对象。
|
||
在更新过的*英雄管理*组件中，我们将直接把`Observable`传给模板，借助`AsyncPipe`在组件被销毁时自动_取消_对`Observable`的订阅。
|
||
|
||
|
||
Now, you can click on the *Admin* button, which takes you to the *Login*
|
||
page with the provided `queryParamMap` and `fragment`. After you click the login button, notice that
|
||
you have been redirected to the `Admin Dashboard` page with the query parameters and fragment still intact in the address bar.
|
||
|
||
按照下列步骤试验下：点击*Crisis Admin*按钮，它会带着我们提供的“查询参数”和“片段”跳转到登录页。
|
||
点击登录按钮，我们就会被带到`Crisis Admin`页，仍然带着上一步提供的“查询参数”和“片段”。
|
||
|
||
You can use these persistent bits of information for things that need to be provided across pages like
|
||
authentication tokens or session ids.
|
||
|
||
我们可以用这些持久化信息来携带需要为每个页面都提供的信息，如认证令牌或会话的ID等。
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
The `query params` and `fragment` can also be preserved using a `RouterLink` with
|
||
the `queryParamsHandling` and `preserveFragment` bindings respectively.
|
||
|
||
“查询参数”和“片段”也可以分别用`RouterLink`中的**preserveQueryParams**和**preserveFragment**保存。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
{@a asynchronous-routing}
|
||
|
||
## Milestone 6: Asynchronous routing
|
||
|
||
## 里程碑6：异步路由
|
||
|
||
As you've worked through the milestones, the application has naturally gotten larger.
|
||
As you continue to build out feature areas, the overall application size will continue to grow.
|
||
At some point you'll reach a tipping point where the application takes long time to load.
|
||
|
||
完成上面的里程碑后，我们的应用程序很自然的长大了。在继续构建特征区的过程中，应用的尺寸将会变得更大。在某一个时间点，我们将达到一个顶点，应用将会需要过多的时间来加载。
|
||
|
||
How do you combat this problem? With asynchronous routing, which loads feature modules _lazily_, on request.
|
||
Lazy loading has multiple benefits.
|
||
|
||
如何才能解决这个问题呢？我们引进了异步路由到应用程序中，并获得在请求时才**惰性**加载特性模块的能力。这样给我们带来了下列好处：
|
||
|
||
* You can load feature areas only when requested by the user.
|
||
|
||
我们可以只在用户请求时才加载某些特性区。
|
||
|
||
* You can speed up load time for users that only visit certain areas of the application.
|
||
|
||
对于那些只访问应用程序某些区域的用户，这样能加快加载速度。
|
||
|
||
* You can continue expanding lazy loaded feature areas without increasing the size of the initial load bundle.
|
||
|
||
我们可以持续扩充惰性加载特性区的功能，而不用增加初始加载的包体积。
|
||
|
||
You're already made part way there.
|
||
By organizing the application into modules—`AppModule`,
|
||
`HeroesModule`, `AdminModule` and `CrisisCenterModule`—you
|
||
have natural candidates for lazy loading.
|
||
|
||
我们已经完成了一部分。通过把应用组织成一些模块：`AppModule`、`HeroesModule`、`AdminModule`和`CrisisCenterModule`，
|
||
我们已经有了可用于实现惰性加载的候选者。
|
||
|
||
Some modules, like `AppModule`, must be loaded from the start.
|
||
But others can and should be lazy loaded.
|
||
The `AdminModule`, for example, is needed by a few authorized users, so
|
||
you should only load it when requested by the right people.
|
||
|
||
有些模块（比如`AppModule`）必须在启动时加载，但其它的都可以而且应该惰性加载。
|
||
比如`AdminModule`就只有少数已认证的用户才需要它，所以我们应该只有在正确的人请求它时才加载。
|
||
|
||
|
||
{@a lazy-loading-route-config}
|
||
|
||
|
||
### Lazy Loading route configuration
|
||
|
||
### 惰性加载路由配置
|
||
|
||
Change the `admin` **path** in the `admin-routing.module.ts` from `'admin'` to an empty string, `''`, the _empty path_.
|
||
|
||
把`admin-routing.module.ts`中的`admin`路径从`'admin'`改为空路径`''`。
|
||
|
||
The `Router` supports *empty path* routes;
|
||
use them to group routes together without adding any additional path segments to the URL.
|
||
Users will still visit `/admin` and the `AdminComponent` still serves as the *Routing Component* containing child routes.
|
||
|
||
`Router`支持*空路径*路由，可以使用它们来分组路由，而不用往URL中添加额外的路径片段。
|
||
用户仍旧访问`/admin`，并且`AdminComponent`仍然作为用来包含子路由的*路由组件*。
|
||
|
||
Open the `AppRoutingModule` and add a new `admin` route to its `appRoutes` array.
|
||
|
||
打开`AppRoutingModule`，并把一个新的`admin`路由添加到它的`appRoutes`数组中。
|
||
|
||
Give it a `loadChildren` property (not a `children` property!), set to the address of the `AdminModule`.
|
||
The address is the `AdminModule` file location (relative to the app root),
|
||
followed by a `#` separator,
|
||
followed by the name of the exported module class, `AdminModule`.
|
||
|
||
给它一个`loadChildren`属性（注意不是`children`属性），把它设置为`AdminModule`的地址。
|
||
该地址是`AdminModule`的文件路径（相对于`app`目录的），加上一个`#`分隔符，再加上导出模块的类名`AdminModule`。
|
||
|
||
|
||
<code-example path="router/src/app/app-routing.module.5.ts" region="admin-1" title="app-routing.module.ts (load children)">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
When the router navigates to this route, it uses the `loadChildren` string to dynamically load the `AdminModule`.
|
||
Then it adds the `AdminModule` routes to its current route configuration.
|
||
Finally, it loads the requested route to the destination admin component.
|
||
|
||
当路由器导航到这个路由时，它会用`loadChildren`字符串来动态加载`AdminModule`，然后把`AdminModule`添加到当前的路由配置中，
|
||
最后，它把所请求的路由加载到目标`admin`组件中。
|
||
|
||
The lazy loading and re-configuration happen just once, when the route is _first_ requested;
|
||
the module and routes are available immediately for subsequent requests.
|
||
|
||
惰性加载和重新配置工作只会发生一次，也就是在该路由*首次*被请求时。在后续的请求中，该模块和路由都是立即可用的。
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
Angular provides a built-in module loader that supports SystemJS to load modules asynchronously. If you were
|
||
using another bundling tool, such as Webpack, you would use the Webpack mechanism for asynchronously loading modules.
|
||
|
||
Angular提供一个内置模块加载器，支持**`SystemJS`**来异步加载模块。如果我们使用其它捆绑工具比如**Webpack**，则使用Webpack的机制来异步加载模块。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
Take the final step and detach the admin feature set from the main application.
|
||
The root `AppModule` must neither load nor reference the `AdminModule` or its files.
|
||
|
||
最后一步是把管理特性区从主应用中完全分离开。
|
||
根模块`AppModule`既不能加载也不能引用`AdminModule`及其文件。
|
||
|
||
In `app.module.ts`, remove the `AdminModule` import statement from the top of the file
|
||
and remove the `AdminModule` from the NgModule's `imports` array.
|
||
|
||
在`app.module.ts`中，从顶部移除`AdminModule`的导入语句，并且从Angular模块的`imports`数组中移除`AdminModule`。
|
||
|
||
|
||
{@a can-load-guard}
|
||
|
||
|
||
### _CanLoad_ Guard: guarding unauthorized loading of feature modules
|
||
|
||
### `CanLoad`守卫：保护对特性模块的未授权加载
|
||
|
||
You're already protecting the `AdminModule` with a `CanActivate` guard that prevents unauthorized users from
|
||
accessing the admin feature area.
|
||
It redirects to the login page if the user is not authorized.
|
||
|
||
我们已经使用`CanAcitvate`保护`AdminModule`了，它会阻止未授权用户访问管理特性区。如果用户未登录，它就会跳转到登录页。
|
||
|
||
But the router is still loading the `AdminModule` even if the user can't visit any of its components.
|
||
Ideally, you'd only load the `AdminModule` if the user is logged in.
|
||
|
||
但是路由器仍然会加载`AdminModule` —— 即使用户无法访问它的任何一个组件。
|
||
理想的方式是，只有在用户已登录的情况下我们才加载`AdminModule`。
|
||
|
||
Add a **`CanLoad`** guard that only loads the `AdminModule` once the user is logged in _and_ attempts to access the admin feature area.
|
||
|
||
添加一个**`CanLoad`**守卫，它只在用户已登录*并且*尝试访问管理特性区的时候，才加载`AdminModule`一次。
|
||
|
||
The existing `AuthGuard` already has the essential logic in
|
||
its `checkLogin()` method to support the `CanLoad` guard.
|
||
|
||
现有的`AuthGuard`的`checkLogin()`方法中已经有了支持`CanLoad`守卫的基础逻辑。
|
||
|
||
Open `auth-guard.service.ts`.
|
||
Import the `CanLoad` interface from `@angular/router`.
|
||
Add it to the `AuthGuard` class's `implements` list.
|
||
Then implement `canLoad()` as follows:
|
||
|
||
打开`auth-guard.service.ts`，从`@angular/router`中导入`CanLoad`接口。
|
||
把它添加到`AuthGuard`类的`implements`列表中。
|
||
然后实现`canLoad`，代码如下：
|
||
|
||
|
||
<code-example path="router/src/app/auth-guard.service.ts" linenums="false" title="src/app/auth-guard.service.ts (CanLoad guard)" region="canLoad">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
The router sets the `canLoad()` method's `route` parameter to the intended destination URL.
|
||
The `checkLogin()` method redirects to that URL once the user has logged in.
|
||
|
||
路由器会把`canLoad()`方法的`route`参数设置为准备访问的目标URL。
|
||
如果用户已经登录了，`checkLogin()`方法就会重定向到那个URL。
|
||
|
||
Now import the `AuthGuard` into the `AppRoutingModule` and add the `AuthGuard` to the `canLoad`
|
||
array property for the `admin` route.
|
||
The completed admin route looks like this:
|
||
|
||
现在，把`AuthGuard`导入到`AppRoutingModule`中，并把`AuthGuard`添加到`admin`路由的`canLoad`数组中。
|
||
完整的`admin`路由是这样的：
|
||
|
||
|
||
<code-example path="router/src/app/app-routing.module.5.ts" region="admin" title="app-routing.module.ts (lazy admin route)">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
{@a preloading}
|
||
|
||
|
||
### Preloading: background loading of feature areas
|
||
|
||
### 预加载：特性区的后台加载
|
||
|
||
You've learned how to load modules on-demand.
|
||
You can also load modules asynchronously with _preloading_.
|
||
|
||
我们已经学会了如何按需加载模块，接下来再看看如何使用*预加载*技术异步加载模块。
|
||
|
||
This may seem like what the app has been doing all along. Not quite.
|
||
The `AppModule` is loaded when the application starts; that's _eager_ loading.
|
||
Now the `AdminModule` loads only when the user clicks on a link; that's _lazy_ loading.
|
||
|
||
看起来好像应用一直都是这么做的，但其实并非如此。
|
||
`AppModule`在应用启动时就被加载了，它是*立即*加载的。
|
||
而`AdminModule`只有当用户点击某个链接时才会加载，它是*惰性*加载的。
|
||
|
||
_Preloading_ is something in between.
|
||
Consider the _Crisis Center_.
|
||
It isn't the first view that a user sees.
|
||
By default, the _Heroes_ are the first view.
|
||
For the smallest initial payload and fastest launch time,
|
||
you should eagerly load the `AppModule` and the `HeroesModule`.
|
||
|
||
*预加载*是介于两者之间的一种方式。
|
||
我们来看看*危机中心*。
|
||
用户第一眼不会看到它。
|
||
默认情况下，*英雄管理*才是第一视图。
|
||
为了获得尽可能小的初始加载体积和最快的加载速度，我们应该对`AppModule`和`HeroesModule`进行立即加载。
|
||
|
||
You could lazy load the _Crisis Center_.
|
||
But you're almost certain that the user will visit the _Crisis Center_ within minutes of launching the app.
|
||
Ideally, the app would launch with just the `AppModule` and the `HeroesModule` loaded
|
||
and then, almost immediately, load the `CrisisCenterModule` in the background.
|
||
By the time the user navigates to the _Crisis Center_, its module will have been loaded and ready to go.
|
||
|
||
我们可以惰性加载*危机中心*。
|
||
但是，我们几乎可以肯定用户会在启动应用之后的几分钟内访问*危机中心*。
|
||
理想情况下，应用启动时应该只加载`AppModule`和`HeroesModule`，然后几乎立即开始后台加载`CrisisCenterModule`。
|
||
在用户浏览到*危机中心*之前，该模块应该已经加载完毕，可供访问了。
|
||
|
||
That's _preloading_.
|
||
|
||
这就是*预加载*。
|
||
|
||
|
||
{@a how-preloading}
|
||
|
||
|
||
#### How preloading works
|
||
|
||
#### 预加载的工作原理
|
||
|
||
After each _successful_ navigation, the router looks in its configuration for an unloaded module that it can preload.
|
||
Whether it preloads a module, and which modules it preloads, depends upon the *preload strategy*.
|
||
|
||
在每次*成功的*导航后，路由器会在自己的配置中查找尚未加载并且可以预加载的模块。
|
||
是否加载某个模块，以及要加载哪些模块，取决于*预加载策略*。
|
||
|
||
The `Router` offers two preloading strategies out of the box:
|
||
|
||
`Router`内置了两种预加载策略：
|
||
|
||
* No preloading at all which is the default. Lazy loaded feature areas are still loaded on demand.
|
||
|
||
完全不预加载，这是默认值。惰性加载的特性区仍然会按需加载。
|
||
|
||
* Preloading of all lazy loaded feature areas.
|
||
|
||
预加载所有惰性加载的特性区。
|
||
|
||
Out of the box, the router either never preloads, or preloads every lazy load module.
|
||
The `Router` also supports [custom preloading strategies](#custom-preloading) for
|
||
fine control over which modules to preload and when.
|
||
|
||
默认情况下，路由器或者完全不预加载或者预加载每个惰性加载模块。
|
||
路由器还支持[自定义预加载策略](guide/router#custom-preloading)，以便完全控制要预加载哪些模块以及何时加载。
|
||
|
||
In this next section, you'll update the `CrisisCenterModule` to load lazily
|
||
by default and use the `PreloadAllModules` strategy
|
||
to load it (and _all other_ lazy loaded modules) as soon as possible.
|
||
|
||
在下一节，我们将会把`CrisisCenterModule`改为默认惰性加载的，并使用`PreloadAllModules`策略来尽快加载它（以及*所有其它*惰性加载模块）。
|
||
|
||
|
||
{@a lazy-load-crisis-center}
|
||
|
||
|
||
#### Lazy load the _crisis center_
|
||
|
||
#### 惰性加载*危机中心*
|
||
|
||
Update the route configuration to lazy load the `CrisisCenterModule`.
|
||
Take the same steps you used to configure `AdminModule` for lazy load.
|
||
|
||
修改路由配置，来惰性加载`CrisisCenterModule`。修改的步骤和配置惰性加载`AdminModule`时一样。
|
||
|
||
1. Change the `crisis-center` path in the `CrisisCenterRoutingModule` to an empty string.
|
||
|
||
把`CrisisCenterRoutingModule`中的路径从`crisis-center`改为空字符串。
|
||
|
||
1. Add a `crisis-center` route to the `AppRoutingModule`.
|
||
|
||
往`AppRoutingModule`中添加一个`crisis-center`路由。
|
||
|
||
1. Set the `loadChildren` string to load the `CrisisCenterModule`.
|
||
|
||
设置`loadChildren`字符串来加载`CrisisCenterModule`。
|
||
|
||
1. Remove all mention of the `CrisisCenterModule` from `app.module.ts`.
|
||
|
||
从`app.module.ts`中移除所有对`CrisisCenterModule`的引用。
|
||
|
||
Here are the updated modules _before enabling preload_:
|
||
|
||
下面是打开预加载之前的模块修改版：
|
||
|
||
|
||
<code-tabs>
|
||
|
||
<code-pane title="app.module.ts" path="router/src/app/app.module.ts">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="app-routing.module.ts" path="router/src/app/app-routing.module.6.ts" region="preload-v1">
|
||
|
||
</code-pane>
|
||
|
||
<code-pane title="crisis-center-routing.module.ts" path="router/src/app/crisis-center/crisis-center-routing.module.ts">
|
||
|
||
</code-pane>
|
||
|
||
</code-tabs>
|
||
|
||
|
||
|
||
You could try this now and confirm that the `CrisisCenterModule` loads after you click the "Crisis Center" button.
|
||
|
||
我们可以现在尝试它，并确认在点击了“Crisis Center”按钮之后加载了`CrisisCenterModule`。
|
||
|
||
To enable preloading of all lazy loaded modules, import the `PreloadAllModules` token from the Angular router package.
|
||
|
||
要为所有惰性加载模块启用预加载功能，请从Angular的路由模块中导入`PreloadAllModules`。
|
||
|
||
The second argument in the `RouterModule.forRoot` method takes an object for additional configuration options.
|
||
The `preloadingStrategy` is one of those options.
|
||
Add the `PreloadAllModules` token to the `forRoot` call:
|
||
|
||
`RouterModule.forRoot`方法的第二个参数接受一个附加配置选项对象。
|
||
`preloadingStrategy`就是其中之一。
|
||
把`PreloadAllModules`添加到`forRoot`调用中：
|
||
|
||
|
||
<code-example path="router/src/app/app-routing.module.6.ts" linenums="false" title="src/app/app-routing.module.ts (preload all)" region="forRoot">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
This tells the `Router` preloader to immediately load _all_ lazy loaded routes (routes with a `loadChildren` property).
|
||
|
||
这会让`Router`预加载器立即加载*所有*惰性加载路由（带`loadChildren`属性的路由）。
|
||
|
||
When you visit `http://localhost:3000`, the `/heroes` route loads immediately upon launch
|
||
and the router starts loading the `CrisisCenterModule` right after the `HeroesModule` loads.
|
||
|
||
当访问`http://localhost:3000`时，`/heroes`路由立即随之启动，并且路由器在加载了`HeroesModule`之后立即开始加载`CrisisCenterModule`。
|
||
|
||
Surprisingly, the `AdminModule` does _not_ preload. Something is blocking it.
|
||
|
||
意外的是，`AdminModule`*没有*预加载，有什么东西阻塞了它。
|
||
|
||
|
||
{@a preload-canload}
|
||
|
||
|
||
#### CanLoad blocks preload
|
||
|
||
#### CanLoad会阻塞预加载
|
||
|
||
The `PreloadAllModules` strategy does not load feature areas protected by a [CanLoad](#can-load-guard) guard.
|
||
This is by design.
|
||
|
||
`PreloadAllModules`策略不会加载被[CanLoad](guide/router#can-load-guard)守卫所保护的特性区。这是刻意设计的。
|
||
|
||
You added a `CanLoad` guard to the route in the `AdminModule` a few steps back
|
||
to block loading of that module until the user is authorized.
|
||
That `CanLoad` guard takes precedence over the preload strategy.
|
||
|
||
我们几步之前刚刚给`AdminModule`中的路由添加了`CanLoad`守卫，以阻塞加载那个模块，直到用户认证结束。
|
||
`CanLoad`守卫的优先级高于预加载策略。
|
||
|
||
If you want to preload a module _and_ guard against unauthorized access,
|
||
drop the `canLoad()` guard method and rely on the [canActivate()](#can-activate-guard) guard alone.
|
||
|
||
如果我们要加载一个模块*并且*保护它防止未授权访问，请移除`canLoad`守卫，只单独依赖[CanActivate](guide/router#can-activate-guard)守卫。
|
||
|
||
|
||
{@a custom-preloading}
|
||
|
||
|
||
### Custom Preloading Strategy
|
||
|
||
### 自定义预加载策略
|
||
|
||
Preloading every lazy loaded modules works well in many situations,
|
||
but it isn't always the right choice, especially on mobile devices and over low bandwidth connections.
|
||
You may choose to preload only certain feature modules, based on user metrics and other business and technical factors.
|
||
|
||
在大多数场景下，预加载每个惰性加载模块就很好了，但是有时候它却并不是正确的选择，特别是在移动设备和低带宽连接下。
|
||
我们可能出于用户的测量和其它商业和技术因素而选择只对某些特性模块进行预加载。
|
||
|
||
You can control what and how the router preloads with a custom preloading strategy.
|
||
|
||
使用自定义预加载策略，我们可以控制路由器预加载哪些路由以及如何加载。
|
||
|
||
In this section, you'll add a custom strategy that _only_ preloads routes whose `data.preload` flag is set to `true`.
|
||
Recall that you can add anything to the `data` property of a route.
|
||
|
||
在这一节，我们将添加一个自定义策略，它*只*预加载那些`data.preload`标志为`true`的路由。
|
||
回忆一下，我们可以往路由的`data`属性中添加任何东西。
|
||
|
||
Set the `data.preload` flag in the `crisis-center` route in the `AppRoutingModule`.
|
||
|
||
在`AppRoutingModule`的`crisis-center`路由中设置`data.preload`标志。
|
||
|
||
|
||
<code-example path="router/src/app/app-routing.module.ts" linenums="false" title="src/app/app-routing.module.ts (route data preload)" region="preload-v2">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Add a new file to the project called `selective-preloading-strategy.ts`
|
||
and define a `SelectivePreloadingStrategy` service class as follows:
|
||
|
||
往项目中添加一个新的名叫`selective-preloading-strategy.ts`的文件，并在其中定义一个服务类`SelectivePreloadingStrategy`，代码如下：
|
||
|
||
|
||
<code-example path="router/src/app/selective-preloading-strategy.ts" linenums="false" title="src/app/selective-preloading-strategy.ts (excerpt)">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
`SelectivePreloadingStrategy` implements the `PreloadingStrategy`, which has one method, `preload`.
|
||
|
||
`SelectivePreloadingStrategy`实现了`PreloadingStrategy`，它只有一个方法`preload`。
|
||
|
||
The router calls the `preload` method with two arguments:
|
||
|
||
路由器会用两个参数调用调用`preload`方法：
|
||
|
||
1. The route to consider.
|
||
|
||
要加载的路由。
|
||
|
||
1. A loader function that can load the routed module asynchronously.
|
||
|
||
一个加载器（loader）函数，它能异步加载带路由的模块。
|
||
|
||
An implementation of `preload` must return an `Observable`.
|
||
If the route should preload, it returns the observable returned by calling the loader function.
|
||
If the route should _not_ preload, it returns an `Observable` of `null`.
|
||
|
||
`preload`的实现必须返回一个`Observable`。
|
||
如果该路由应该预加载，它就会返回调用加载器函数所返回的`Observable`。
|
||
如果该路由*不*应该预加载，它就返回一个`null`值的`Observable`对象。
|
||
|
||
In this sample, the `preload` method loads the route if the route's `data.preload` flag is truthy.
|
||
|
||
在这个例子中，`preload`方法只有在路由的`data.preload`标识为真时才会加载该路由。
|
||
|
||
It also has a side-effect.
|
||
`SelectivePreloadingStrategy` logs the `path` of a selected route in its public `preloadedModules` array.
|
||
|
||
它还有一个副作用。
|
||
`SelectivePreloadingStrategy`会把所选路由的`path`记录在它的公共数组`preloadedModules`中。
|
||
|
||
Shortly, you'll extend the `AdminDashboardComponent` to inject this service and display its `preloadedModules` array.
|
||
|
||
很快，我们就会扩展`AdminDashboardComponent`来注入该服务，并且显示它的`preloadedModules`数组。
|
||
|
||
But first, make a few changes to the `AppRoutingModule`.
|
||
|
||
但是首先，要对`AppRoutingModule`做少量修改。
|
||
|
||
1. Import `SelectivePreloadingStrategy` into `AppRoutingModule`.
|
||
把`SelectivePreloadingStrategy`导入到`AppRoutingModule`中。1. Replace the `PreloadAllModules` strategy in the call to `forRoot` with this `SelectivePreloadingStrategy`. 把`PreloadAllModules`策略替换成对`forRoot`的调用，并且传入这个`SelectivePreloadingStrategy`。
|
||
1. Add the `SelectivePreloadingStrategy` strategy to the `AppRoutingModule` providers array so it can be injected
|
||
elsewhere in the app.
|
||
|
||
把`SelectivePreloadingStrategy`策略添加到`AppRoutingModule`的`providers`数组中，以便它可以注入到应用中的任何地方。
|
||
|
||
Now edit the `AdminDashboardComponent` to display the log of preloaded routes.
|
||
|
||
现在，编辑`AdminDashboardComponent`以显示这些预加载路由的日志。
|
||
|
||
1. Import the `SelectivePreloadingStrategy` (it's a service).
|
||
|
||
导入`SelectivePreloadingStrategy`（它是一个服务）。
|
||
|
||
1. Inject it into the dashboard's constructor.
|
||
|
||
把它注入到仪表盘的构造函数中。
|
||
|
||
1. Update the template to display the strategy service's `preloadedModules` array.
|
||
|
||
修改模板来显示这个策略服务的`preloadedModules`数组。
|
||
|
||
When you're done it looks like this.
|
||
|
||
当完成时，代码如下：
|
||
|
||
|
||
<code-example path="router/src/app/admin/admin-dashboard.component.ts" linenums="false" title="src/app/admin/admin-dashboard.component.ts (preloaded modules)">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Once the application loads the initial route, the `CrisisCenterModule` is preloaded.
|
||
Verify this by logging in to the `Admin` feature area and noting that the `crisis-center` is listed in the `Preloaded Modules`.
|
||
It's also logged to the browser's console.
|
||
|
||
一旦应用加载完了初始路由，`CrisisCenterModule`也被预加载了。
|
||
通过`Admin`特性区中的记录就可以验证它，我们会看到“Preloaded Modules”中没有列出`crisis-center`。
|
||
它也被记录到了浏览器的控制台。
|
||
|
||
|
||
{@a inspect-config}
|
||
|
||
|
||
|
||
## Inspect the router's configuration
|
||
|
||
## 审查路由器配置
|
||
|
||
You put a lot of effort into configuring the router in several routing module files
|
||
and were careful to list them [in the proper order](#routing-module-order).
|
||
Are routes actually evaluated as you planned?
|
||
How is the router really configured?
|
||
|
||
我们把大量的精力投入到在一系列路由模块文件里配置路由器上，并且小心的[以合适的顺序](guide/router#routing-module-order)列出它们。
|
||
这些路由是否真的如同你预想的那样执行了？
|
||
路由器的真实配置是怎样的？
|
||
|
||
You can inspect the router's current configuration any time by injecting it and
|
||
examining its `config` property.
|
||
For example, update the `AppModule` as follows and look in the browser console window
|
||
to see the finished route configuration.
|
||
|
||
通过注入它（Router）并检查它的`config`属性，我们可以随时审查路由器的当前配置。
|
||
例如，把`AppModule`修改为这样，并在浏览器的控制台窗口中查看最终的路由配置。
|
||
|
||
|
||
<code-example path="router/src/app/app.module.ts" linenums="false" title="src/app/app.module.ts (inspect the router config)" region="inspect-config">
|
||
|
||
</code-example>
|
||
|
||
|
||
{@a final-app}
|
||
|
||
|
||
## Wrap up and final app
|
||
|
||
## 总结与最终的应用
|
||
|
||
You've covered a lot of ground in this guide and the application is too big to reprint here.
|
||
Please visit the <live-example title="Router Sample in Plunker"></live-example>
|
||
where you can download the final source code.
|
||
|
||
本章中涉及到了很多背景知识，而且本应用程序也太大了，所以没法在这里显示。请访问<live-example title="Router Sample in Plunker"></live-example>，在那里你可以下载最终的源码。
|
||
|
||
|
||
{@a appendices}
|
||
|
||
|
||
|
||
## Appendices
|
||
|
||
## 附录
|
||
|
||
The balance of this guide is a set of appendices that
|
||
elaborate some of the points you covered quickly above.
|
||
|
||
本章剩下的部分是一组附录，它详尽阐述了我们曾匆匆带过的一些知识点。
|
||
|
||
The appendix material isn't essential. Continued reading is for the curious.
|
||
|
||
该附件中的内容不是必须的，感兴趣的人才需要阅读它。
|
||
|
||
|
||
{@a link-parameters-array}
|
||
|
||
|
||
|
||
### Appendix: link parameters array
|
||
|
||
## 附录：链接参数数组
|
||
|
||
A link parameters array holds the following ingredients for router navigation:
|
||
|
||
链接参数数组保存路由导航时所需的成分：
|
||
|
||
* The *path* of the route to the destination component.
|
||
|
||
指向目标组件的那个路由的*路径（path）*
|
||
|
||
* Required and optional route parameters that go into the route URL.
|
||
|
||
必备路由参数和可选路由参数，它们将进入该路由的URL
|
||
|
||
You can bind the `RouterLink` directive to such an array like this:
|
||
|
||
我们可以把`RouterLink`指令绑定到一个数组，就像这样：
|
||
|
||
|
||
<code-example path="router/src/app/app.component.3.ts" linenums="false" title="src/app/app.component.ts (h-anchor)" region="h-anchor">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
You've written a two element array when specifying a route parameter like this:
|
||
|
||
在指定路由参数时，我们写过一个双元素的数组，就像这样：
|
||
|
||
|
||
<code-example path="router/src/app/heroes/hero-list.component.1.ts" linenums="false" title="src/app/heroes/hero-list.component.ts (nav-to-detail)" region="nav-to-detail">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
You can provide optional route parameters in an object like this:
|
||
|
||
我们可以在对象中提供可选的路由参数，就像这样：
|
||
|
||
|
||
<code-example path="router/src/app/app.component.3.ts" linenums="false" title="src/app/app.component.ts (cc-query-params)" region="cc-query-params">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
These three examples cover the need for an app with one level routing.
|
||
The moment you add a child router, such as the crisis center, you create new link array possibilities.
|
||
|
||
这三个例子涵盖了我们在单级路由的应用中所需的一切。在添加一个像*危机中心*一样的子路由时，我们创建新链接数组组合。
|
||
|
||
Recall that you specified a default child route for the crisis center so this simple `RouterLink` is fine.
|
||
|
||
回忆一下，我们曾为*危机中心*指定过一个默认的子路由，以便能使用这种简单的`RouterLink`。
|
||
|
||
|
||
<code-example path="router/src/app/app.component.3.ts" linenums="false" title="src/app/app.component.ts (cc-anchor-w-default)" region="cc-anchor-w-default">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Parse it out.
|
||
|
||
分解一下。
|
||
|
||
* The first item in the array identifies the parent route (`/crisis-center`).
|
||
|
||
数组中的第一个条目标记出了父路由(`/crisis-center`)。
|
||
|
||
* There are no parameters for this parent route so you're done with it.
|
||
|
||
这个父路由没有参数，因此这步已经完成了。
|
||
|
||
* There is no default for the child route so you need to pick one.
|
||
|
||
没有默认的子路由，因此我们得选取一个。
|
||
|
||
* You're navigating to the `CrisisListComponent`, whose route path is `/`, but you don't need to explicitly add the slash.
|
||
|
||
我们决定跳转到`CrisisListComponent`，它的路由路径是'/'，但我们不用显式的添加它。
|
||
|
||
* Voilà! `['/crisis-center']`.
|
||
|
||
哇！`['/crisis-center']`。
|
||
|
||
Take it a step further. Consider the following router link that
|
||
navigates from the root of the application down to the *Dragon Crisis*:
|
||
|
||
在下一步，我们会用到它。这次，我们要构建一个从根组件往下导航到“巨龙危机”时的链接参数数组：
|
||
|
||
|
||
<code-example path="router/src/app/app.component.3.ts" linenums="false" title="src/app/app.component.ts (Dragon-anchor)" region="Dragon-anchor">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
* The first item in the array identifies the parent route (`/crisis-center`).
|
||
|
||
数组中的第一个条目用来标记出父路由('/crisis-center')。
|
||
|
||
* There are no parameters for this parent route so you're done with it.
|
||
|
||
这个父路由没有参数，因此这步已经完成了。
|
||
|
||
* The second item identifies the child route details about a particular crisis (`/:id`).
|
||
|
||
数组中的第二个条目（'/:id'）用来标记出到指定危机的详情页的子路由。
|
||
|
||
* The details child route requires an `id` route parameter.
|
||
|
||
详细的子路由需要一个`id`路由参数。
|
||
|
||
* You added the `id` of the *Dragon Crisis* as the second item in the array (`1`).
|
||
|
||
我们把*巨龙危机*的`id`添加为该数组中的第二个条目（`1`）。
|
||
|
||
* The resulting path is `/crisis-center/1`.
|
||
|
||
最终生成的路径是`/crisis-center/1`。
|
||
|
||
|
||
If you wanted to, you could redefine the `AppComponent` template with *Crisis Center* routes exclusively:
|
||
|
||
只要想，我们也可以用*危机中心*路由单独重定义`AppComponent`的模板：
|
||
|
||
|
||
<code-example path="router/src/app/app.component.3.ts" linenums="false" title="src/app/app.component.ts (template)" region="template">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
In sum, you can write applications with one, two or more levels of routing.
|
||
The link parameters array affords the flexibility to represent any routing depth and
|
||
any legal sequence of route paths, (required) router parameters, and (optional) route parameter objects.
|
||
|
||
总结：我们可以用一级、两级或多级路由来写应用程序。
|
||
链接参数数组提供了用来表示任意深度路由的链接参数数组以及任意合法的路由参数序列、必须的路由器参数以及可选的路由参数对象。
|
||
|
||
|
||
{@a browser-url-styles}
|
||
|
||
|
||
{@a location-strategy}
|
||
|
||
|
||
|
||
### Appendix: *LocationStrategy* and browser URL styles
|
||
|
||
## 附录：*LocationStrategy*以及浏览器URL样式
|
||
|
||
When the router navigates to a new component view, it updates the browser's location and history
|
||
with a URL for that view.
|
||
This is a strictly local URL. The browser shouldn't send this URL to the server
|
||
and should not reload the page.
|
||
|
||
当路由器导航到一个新的组件视图时，它会用该视图的URL来更新浏览器的当前地址以及历史。
|
||
严格来说，这个URL其实是本地的，浏览器不会把该URL发给服务器，并且不会重新加载此页面。
|
||
|
||
Modern HTML5 browsers support
|
||
<a href="https://developer.mozilla.org/en-US/docs/Web/API/History_API#Adding_and_modifying_history_entries" title="HTML5 browser history push-state">history.pushState</a>,
|
||
a technique that changes a browser's location and history without triggering a server page request.
|
||
The router can compose a "natural" URL that is indistinguishable from
|
||
one that would otherwise require a page load.
|
||
|
||
现代HTML 5浏览器支持[history.pushState](https://developer.mozilla.org/en-US/docs/Web/API/History_API#Adding_and_modifying_history_entries) API，
|
||
这是一项可以改变浏览器的当前地址和历史，却又不会触发服务端页面请求的技术。
|
||
路由器可以合成出一个“自然的”URL，它看起来和那些需要进行页面加载的URL没什么区别。
|
||
|
||
Here's the *Crisis Center* URL in this "HTML5 pushState" style:
|
||
|
||
下面是*危机中心*的URL在“HTML 5 pushState”风格下的样子：
|
||
|
||
|
||
<code-example format="nocode">
|
||
localhost:3002/crisis-center/
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Older browsers send page requests to the server when the location URL changes
|
||
_unless_ the change occurs after a "#" (called the "hash").
|
||
Routers can take advantage of this exception by composing in-application route
|
||
URLs with hashes. Here's a "hash URL" that routes to the *Crisis Center*.
|
||
|
||
老旧的浏览器在当前地址的URL变化时总会往服务器发送页面请求……唯一的例外规则是：当这些变化位于“#”（被称为“hash”）后面时不会发送。通过把应用内的路由URL拼接在`#`之后，路由器可以获得这条“例外规则”带来的优点。下面是到*危机中心*路由的“hash URL”：
|
||
|
||
|
||
<code-example format="nocode">
|
||
localhost:3002/src/#/crisis-center/
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
The router supports both styles with two `LocationStrategy` providers:
|
||
|
||
路由器通过两种`LocationStrategy`提供商来支持所有这些风格：
|
||
|
||
1. `PathLocationStrategy`—the default "HTML5 pushState" style.
|
||
|
||
`PathLocationStrategy` - 默认的策略，支持“HTML 5 pushState”风格。
|
||
|
||
1. `HashLocationStrategy`—the "hash URL" style.
|
||
|
||
`HashLocationStrategy` - 支持“hash URL”风格。
|
||
|
||
The `RouterModule.forRoot` function sets the `LocationStrategy` to the `PathLocationStrategy`,
|
||
making it the default strategy.
|
||
You can switch to the `HashLocationStrategy` with an override during the bootstrapping process if you prefer it.
|
||
|
||
`RouterModule.forRoot`函数把`LocationStrategy`设置成了`PathLocationStrategy`，使其成为了默认策略。
|
||
我们可以在启动过程中改写（override）它，来切换到`HashLocationStrategy`风格 —— 如果我们更喜欢这种。
|
||
|
||
|
||
<div class="l-sub-section">
|
||
|
||
|
||
|
||
Learn about providers and the bootstrap process in the
|
||
[Dependency Injection guide](guide/dependency-injection#bootstrap).
|
||
|
||
要学习关于“提供商”和启动过程的更多知识，参见[依赖注入](guide/dependency-injection#bootstrap)一章。
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
#### Which strategy is best?
|
||
|
||
### 哪种策略更好？
|
||
|
||
You must choose a strategy and you need to make the right call early in the project.
|
||
It won't be easy to change later once the application is in production
|
||
and there are lots of application URL references in the wild.
|
||
|
||
我们必须选择一种策略，并且在项目的早期就这么干。一旦该应用进入了生产阶段，要改起来可就不容易了，因为外面已经有了大量对应用URL的引用。
|
||
|
||
Almost all Angular projects should use the default HTML5 style.
|
||
It produces URLs that are easier for users to understand.
|
||
And it preserves the option to do _server-side rendering_ later.
|
||
|
||
几乎所有的Angular项目都会使用默认的HTML 5风格。它生成的URL更易于被用户理解，它也为将来做**服务端渲染**预留了空间。
|
||
|
||
Rendering critical pages on the server is a technique that can greatly improve
|
||
perceived responsiveness when the app first loads.
|
||
An app that would otherwise take ten or more seconds to start
|
||
could be rendered on the server and delivered to the user's device
|
||
in less than a second.
|
||
|
||
在服务器端渲染指定的页面，是一项可以在该应用首次加载时大幅提升响应速度的技术。那些原本需要十秒甚至更长时间加载的应用，可以预先在服务端渲染好，并在少于一秒的时间内完整呈现在用户的设备上。
|
||
|
||
This option is only available if application URLs look like normal web URLs
|
||
without hashes (#) in the middle.
|
||
|
||
只有当应用的URL看起来像是标准的Web URL，中间没有hash（#）时，这个选项才能生效。
|
||
|
||
Stick with the default unless you have a compelling reason to
|
||
resort to hash routes.
|
||
|
||
除非你有强烈的理由不得不使用hash路由，否则就应该坚决使用默认的HTML 5路由风格。
|
||
|
||
#### HTML5 URLs and the *<base href>*
|
||
|
||
### HTML 5 URL与*<base href>*While the router uses the
|
||
<a href="https://developer.mozilla.org/en-US/docs/Web/API/History_API#Adding_and_modifying_history_entries" title="Browser history push-state">HTML5 pushState</a>
|
||
style by default, you *must* configure that strategy with a **base href**.
|
||
|
||
由于路由器默认使用“<a href="https://developer.mozilla.org/en-US/docs/Web/API/History_API#Adding_and_modifying_history_entries" target="_blank" title="Browser history push-state">HTML 5 pushState</a>”风格，所以我们*必须*用一个**base href**来配置该策略（Strategy）。
|
||
|
||
The preferred way to configure the strategy is to add a
|
||
<a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/base" title="base href"><base href> element</a>
|
||
tag in the `<head>` of the `index.html`.
|
||
|
||
配置该策略的首选方式是往`index.html`的`<head>`中添加一个[<base href> element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/base)标签。
|
||
|
||
|
||
<code-example path="router/src/index.html" linenums="false" title="src/index.html (base-href)" region="base-href">
|
||
|
||
</code-example>
|
||
|
||
|
||
|
||
Without that tag, the browser may not be able to load resources
|
||
(images, CSS, scripts) when "deep linking" into the app.
|
||
Bad things could happen when someone pastes an application link into the
|
||
browser's address bar or clicks such a link in an email.
|
||
|
||
如果没有此标签，当通过“深链接”进入该应用时，浏览器就不能加载资源（图片、CSS、脚本）。如果有人把应用的链接粘贴进浏览器的地址栏或从邮件中点击应用的链接时，这种问题就发生。
|
||
|
||
Some developers may not be able to add the `<base>` element, perhaps because they don't have
|
||
access to `<head>` or the `index.html`.
|
||
|
||
有些开发人员可能无法添加`<base>`元素，这可能是因为它们没有访问`<head>`或`index.html`的权限。
|
||
|
||
Those developers may still use HTML5 URLs by taking two remedial steps:
|
||
|
||
它们仍然可以使用HTML 5格式的URL，但要采取两个步骤进行补救：
|
||
|
||
1. Provide the router with an appropriate [APP_BASE_HREF][] value.
|
||
|
||
用适当的[APP_BASE_HREF][]值提供（provide）路由器。
|
||
|
||
1. Use _root URLs_ for all web resources: CSS, images, scripts, and template HTML files.
|
||
|
||
对所有Web资源使用**绝对地址**：CSS、图片、脚本、模板HTML。
|
||
|
||
{@a hashlocationstrategy}
|
||
|
||
#### *HashLocationStrategy*
|
||
|
||
You can go old-school with the `HashLocationStrategy` by
|
||
providing the `useHash: true` in an object as the second argument of the `RouterModule.forRoot`
|
||
in the `AppModule`.
|
||
|
||
我们可以在根模块的`RouterModule.forRoot`的第二个参数中传入一个带有`useHash: true`的对象，以回到基于`HashLocationStrategy`的传统方式。
|
||
|
||
|
||
<code-example path="router/src/app/app.module.6.ts" linenums="false" title="src/app/app.module.ts (hash URL strategy)">
|
||
|
||
</code-example>
|