路由快速入門

2018-06-06 08:41 更新

路由是 Angular 應(yīng)用程序的核心，它加載與所請求路由相關(guān)聯(lián)的組件，以及獲取特定路由的相關(guān)數(shù)據(jù)。這允許我們通過控制不同的路由，獲取不同的數(shù)據(jù)，從而渲染不同的頁面。

接下來我們將按照以下目錄的內(nèi)容，介紹 Angular 的路由。

目錄

  • Installing the router
    • Base href
  • Using the router
    • RouterModule.forRoot
    • RouterModule.forChild
  • Configuring a route
  • Displaying routes
  • Futher configuration
    • Dynamic routes
    • Child routes
    • Component-less routes
    • loadChildren
  • Router directives
    • routerLink
    • routerLinkActive
  • Router API

Installing the router

首先第一件事，我們需要安裝 Angular Router。你可以通過運(yùn)行以下任一操作來執(zhí)行此操作：

  1. yarn add @angular/router
  2. ## OR
  3. npm i --save @angular/router

以上命令執(zhí)行后，將會自動下載 @angular/router 模塊到 node_modules 文件夾中。

Base href

我們需要做的最后一件事，是將 <base> 標(biāo)簽添加到我們的 index.html 文件中。路由需要根據(jù)這個來確定應(yīng)用程序的根目錄。例如，當(dāng)我們轉(zhuǎn)到 http://example.com/page1 時，如果我們沒有定義應(yīng)用程序的基礎(chǔ)路徑，路由將無法知道我們的應(yīng)用的托管地址是 http://example.com 還是 http://example.com/page1 。

這件事操作起來很簡單，只需打開項目中的 index.html 文件，添加相應(yīng)的 <base> 標(biāo)簽，具體如下：

  1. <!doctype html>
  2. <html>
  3.   <head>
  4.     <base href="/">
  5.     <title>Application</title>
  6.   </head>
  7.   <body>
  8.     <app-root></app-root>
  9.   </body>
  10. </html>

以上配置信息告訴 Angular 路由，應(yīng)用程序的根目錄是 / 。

Using the router

要使用路由，我們需要在 AppModule 模塊中，導(dǎo)入 RouterModule。具體如下：

  1. import { NgModule } from '@angular/core';
  2. import { BrowserModule } from '@angular/platform-browser';
  3. import { RouterModule } from '@angular/router';
  6. import { AppComponent } from './app.component';
  9. @NgModule({
  10.   imports: [
  11.     BrowserModule,
  12.     RouterModule
  13.   ],
  14.   bootstrap: [
  15.     AppComponent
  16.   ],
  17.   declarations: [
  18.     AppComponent
  19.   ]
  20. })
  21. export class AppModule {}

此時我們的路由還不能正常工作，因?yàn)槲覀冞€未配置應(yīng)用程序路由的相關(guān)信息。RouterModule 對象為我們提供了兩個靜態(tài)的方法：forRoot() 和 forChild() 來配置路由信息。

RouterModule.forRoot()

RouterModule.forRoot() 方法用于在主模塊中定義主要的路由信息，通過調(diào)用該方法使得我們的主模塊可以訪問路由模塊中定義的所有指令。接下來我們來看一下如何使用 forRoot() ：

  1. // ...
  2. import { Routes, RouterModule } from '@angular/router';
  5. export const ROUTES: Routes = [];
  8. @NgModule({
  9.   imports: [
  10.     BrowserModule,
  11.     RouterModule.forRoot(ROUTES)
  12.   ],
  13.   // ...
  14. })
  15. export class AppModule {}

我們通過使用 const 定義路由的配置信息，然后把它作為參數(shù)調(diào)用 RouterModule.forRoot() 方法，而不是直接使用 RouterModule.forRoot([...]) 這種方式，這樣做的好處是方便我們在需要的時候?qū)С?ROUTES 到其它模塊中。

RouterModule.forChild()

RouterModule.forChild() 與 Router.forRoot() 方法類似，但它只能應(yīng)用在特性模塊中。

友情提示：根模塊中使用 forRoot()，子模塊中使用 forChild()

這個功能非常強(qiáng)大，因?yàn)槲覀儾槐卦谝粋€地方（我們的主模塊）定義所有路由信息。反之，我們可以在特性模塊中定義模塊特有的路由信息，并在必要的時候?qū)⑺鼈儗?dǎo)入我們主模塊。RouterModule.forChild() 的使用方法如下：

  1. import { NgModule } from '@angular/core';
  2. import { CommonModule } from '@angular/common';
  3. import { Routes, RouterModule } from '@angular/router';
  6. export const ROUTES: Routes = [];
  9. @NgModule({
  10.   imports: [
  11.     CommonModule,
  12.     RouterModule.forChild(ROUTES)
  13.   ],
  14.   // ...
  15. })
  16. export class ChildModule {}

通過以上示例，我們知道在主模塊和特性模塊中，路由配置對象的類型是一樣的，區(qū)別只是主模塊和特性模塊中需調(diào)用不同的方法，來配置模塊路由。接下來我們來介紹一下如何配置 ROUTES 對象。

Configuring a route

我們定義的所有路由都是作為 ROUTES 數(shù)組中的對象。首先，為我們的主頁定義一個路由：

  1. import { Routes, RouterModule } from '@angular/router';
  4. import { HomeComponent } from './home/home.component';
  7. export const ROUTES: Routes = [
  8.   { path: '', component: HomeComponent }
  9. ];
  12. @NgModule({
  13.   imports: [
  14.     BrowserModule,
  15.     RouterModule.forRoot(ROUTES)
  16.   ],
  17.   // ...
  18. })
  19. export class AppModule {}

示例中我們通過 path 屬性定義路由的匹配路徑，而 component 屬性用于定義路由匹配時需要加載的組件。

友情提示：我們使用 path: '' 來匹配空的路徑，例如：https://yourdomain.com

Displaying routes

配置完路由信息后，下一步是使用一個名為 router-outlet 的指令告訴 Angular 在哪里加載組件。當(dāng) Angular 路由匹配到響應(yīng)路徑，并成功找到需要加載的組件時，它將動態(tài)創(chuàng)建對應(yīng)的組件，并將其作為兄弟元素，插入到 router-outlet 元素中。

在我們 AppComponent 組件中，我們可以在任意位置插入 router-outlet 指令：

  1. import { Component } from '@angular/core';
  4. @Component({
  5.   selector: 'app-root',
  6.   template: `
  7.     <div class="app">
  8.       <h3>Our app</h3>
  9.       <router-outlet></router-outlet>
  10.     </div>
  11.   `
  12. })
  13. export class AppComponent {}

我們現(xiàn)在已經(jīng)建立了應(yīng)用程序的主路由，我們可以進(jìn)一步了解路由的其它配置選項。

Further configuration

到目前為止我們已經(jīng)介紹的內(nèi)容只是一個開始 ，接下來我們來看看其它一些選項和功能。

Dynamic routes

如果路由始終是靜態(tài)的，那沒有多大的用處。例如 path: '' 是加載我們 HomeComponent 組件的靜態(tài)路由。我們將介紹動態(tài)路由，基于動態(tài)路由我們可以根據(jù)不同的路由參數(shù)，渲染不同的頁面。

例如，如果我們想要在個人資料頁面根據(jù)不同的用戶名顯示不同的用戶信息，我們可以使用以下方式定義路由：

  1. import { HomeComponent } from './home/home.component';
  2. import { ProfileComponent } from './profile/profile.component';
  5. export const ROUTES: Routes = [
  6.   { path: '', component: HomeComponent },
  7.   { path: '/profile/:username', component: ProfileComponent }
  8. ];

這里的關(guān)鍵點(diǎn)是 : ，它告訴 Angular 路由，:username 是路由參數(shù)，而不是 URL 中實(shí)際的部分。

友情提示：如果沒有使用 : ，它將作為靜態(tài)路由，僅匹配 /profile/username 路徑

現(xiàn)在我們已經(jīng)建立一個動態(tài)路由，此時最重要的事情就是如何獲取路由參數(shù)。要訪問當(dāng)前路由的相關(guān)信息，我們需要先從 @angular/router 模塊中導(dǎo)入 ActivatedRoute ，然后在組件類的構(gòu)造函數(shù)中注入該對象，最后通過訂閱該對象的 params 屬性，來獲取路由參數(shù)，具體示例如下：

  1. import { Component, OnInit } from '@angular/core';
  2. import { ActivatedRoute } from '@angular/router';
  5. @Component({
  6.   selector: 'profile-page',
  7.   template: `
  8.     <div class="profile">
  9.       <h3>{{ username }}</h3>
  10.     </div>
  11.   `
  12. })
  13. export class SettingsComponent implements OnInit {
  14.   username: string;
  15.   constructor(private route: ActivatedRoute) {}
  16.   ngOnInit() {
  17.     this.route.params.subscribe((params) => this.username = params.username);
  18.   }
  19. }

介紹完動態(tài)路由，我們來探討一下如何創(chuàng)建 child routes。

Child routes

實(shí)際上每個路由都支持子路由，假設(shè)在我們 /settings 設(shè)置頁面下有 /settings/profile 和 /settings/password 兩個頁面，分別表示個人資料頁和修改密碼頁。

我們可能希望我們的 / settings 頁面擁有自己的組件，然后在設(shè)置頁面組件中顯示 / settings/profile 和 / settings/password 頁面。我們可以這樣做：

  1. import { SettingsComponent } from './settings/settings.component';
  2. import { ProfileSettingsComponent } from './settings/profile/profile.component';
  3. import { PasswordSettingsComponent } from './settings/password/password.component';
  6. export const ROUTES: Routes = [
  7.   { 
  8.     path: 'settings', 
  9.     component: SettingsComponent,
  10.     children: [
  11.       { path: 'profile', component: ProfileSettingsComponent },
  12.       { path: 'password', component: PasswordSettingsComponent }
  13.     ]
  14.   }
  15. ];
  18. @NgModule({
  19.   imports: [
  20.     BrowserModule,
  21.     RouterModule.forRoot(ROUTES)
  22.   ],
  23. })
  24. export class AppModule {}

在這里，我們在 setttings 路由中定義了兩個子路由，它們將繼承父路由的路徑，因此修改密碼頁面的路由匹配地址是 /settings/password ，依此類推。

接下來，我們需要做的最后一件事是在我們的 SettingsComponent 組件中添加 router-outlet 指令，因?yàn)槲覀円谠O(shè)置頁面中呈現(xiàn)子路由。如果我們沒有在 SettingsComponent 組件中添加 router-outlet 指令，盡管 /settings/password 匹配修改密碼頁面的路由地址，但修改密碼頁面將無法正常顯示。具體代碼如下：

  1. import { Component } from '@angular/core';
  4. @Component({
  5.   selector: 'settings-page',
  6.   template: `
  7.     <div class="settings">
  8.       <settings-header></settings-header>
  9.       <settings-sidebar></settings-sidebar>
  10.       <router-outlet></router-outlet>
  11.     </div>
  12.   `
  13. })
  14. export class SettingsComponent {}

Component-less routes

另一個很有用的路由功能是 component-less 路由。使用 component-less 路由允許我們將路由組合在一起，并讓它們共享路由配置信息和 outlet。

例如，我們可以定義 setttings 路由而不需要使用 SettingsComponent 組件：

  1. import { ProfileSettingsComponent } from './settings/profile/profile.component';
  2. import { PasswordSettingsComponent } from './settings/password/password.component';
  5. export const ROUTES: Routes = [
  6.   {
  7.     path: 'settings',
  8.     children: [
  9.       { path: 'profile', component: ProfileSettingsComponent },
  10.       { path: 'password', component: PasswordSettingsComponent }
  11.     ]
  12.   }
  13. ];
  16. @NgModule({
  17.   imports: [
  18.     BrowserModule,
  19.     RouterModule.forRoot(ROUTES)
  20.   ],
  21. })
  22. export class AppModule {}

此時， /settings/profile 和 /settings/password 路由定義的內(nèi)容，將顯示在 AppComponent 組件的 router-outlet 元素中。

loadChildren

我們也可以告訴路由從另一個模塊中獲取子路由。這將我們談?wù)摰膬蓚€想法聯(lián)系在一起 - 我們可以指定另一個模塊中定義的子路由，以及通過將這些子路由設(shè)置到特定的路徑下，來充分利用 component-less 路由的功能。

讓我們創(chuàng)建一個 SettingsModule 模塊，用來保存所有 setttings 相關(guān)的路由信息：

  1. import { NgModule } from '@angular/core';
  2. import { CommonModule } from '@angular/common';
  3. import { Routes, RouterModule } from '@angular/router';
  6. export const ROUTES: Routes = [
  7.   {
  8.     path: '',
  9.     component: SettingsComponent,
  10.     children: [
  11.       { path: 'profile', component: ProfileSettingsComponent },
  12.       { path: 'password', component: PasswordSettingsComponent }
  13.     ]
  14.   }
  15. ];
  18. @NgModule({
  19.   imports: [
  20.     CommonModule,
  21.     RouterModule.forChild(ROUTES)
  22.   ],
  23. })
  24. export class SettingsModule {}

需要注意的是，在 SettingsModule 模塊中我們使用 forChild() 方法，因?yàn)?SettingsModule 不是我們應(yīng)用的主模塊。

另一個主要的區(qū)別是我們將 SettingsModule 模塊的主路徑設(shè)置為空路徑 ('')。因?yàn)槿绻覀兟窂皆O(shè)置為 /settings ，它將匹配 /settings/settings ，很明顯這不是我們想要的結(jié)果。通過指定一個空的路徑，它就會匹配 /settings 路徑，這就是我們想要的結(jié)果。

那么 /settings 路由信息，需要在哪里配置？答案是在 AppModule 中。這時我們就需要用到 loadChildren 屬性，具體如下：

  1. export const ROUTES: Routes = [
  2.   {
  3.     path: 'settings',
  4.     loadChildren: './settings/settings.module#SettingsModule'
  5.   }
  6. ];
  9. @NgModule({
  10.   imports: [
  11.     BrowserModule,
  12.     RouterModule.forRoot(ROUTES)
  13.   ],
  14.   // ...
  15. })
  16. export class AppModule {}

需要注意的是，我們沒有將 SettingsModule 導(dǎo)入到我們的 AppModule 中，而是通過 loadChildren 屬性，告訴 Angular 路由依據(jù) loadChildren 屬性配置的路徑去加載 SettingsModule 模塊。這就是模塊懶加載功能的具體應(yīng)用，當(dāng)用戶訪問 /settings/** 路徑的時候，才會加載對應(yīng)的 SettingsModule 模塊，這減少了應(yīng)用啟動時加載資源的大小。

另外我們傳遞一個字符串作為 loadChildren 的屬性值，該字符串由三部分組成：

  • 需要導(dǎo)入模塊的相對路徑
  • # 分隔符
  • 導(dǎo)出模塊類的名稱

了解完路由的一些高級選項和功能，接下來我們來介紹路由指令。

Router Directives

除了 router-outlet 指令，路由模塊中還提供了一些其它指令。讓我們來看看它們?nèi)绾闻c我們之前介紹的內(nèi)容結(jié)合使用。

routerLink

為了讓我們鏈接到已設(shè)置的路由，我們需要使用 routerLink 指令，具體示例如下：

  1. <nav>
  2.   <a routerLink="/">Home</a>
  3.   <a routerLink="/settings/password">Change password</a>
  4.   <a routerLink="/settings/profile">Profile Settings</a>
  5. </nav>

當(dāng)我們點(diǎn)擊以上的任意鏈接時，頁面不會被重新加載。反之，我們的路徑將在 URL 地址欄中顯示，隨后進(jìn)行后續(xù)視圖更新，以匹配 routerLink 中設(shè)置的值。

友情提示：我們也可以將 routerLink 的屬性值，改成數(shù)組形式，以便我們傳遞特定的路由信息

如果我們想要鏈接到動態(tài)的路由地址，且該地址有一個 username 的路由變量，則我們可以按照以下方式配置 routerLink 對應(yīng)的屬性值：

  1. <a [routerLink]="['/profile', username]">
  2.   Go to {{ username }}'s profile.
  3. </a>

routerLinkActive

在實(shí)際開發(fā)中，我們需要讓用戶知道哪個路由處于激活狀態(tài)，通常情況下我們通過向激活的鏈接添加一個 class 來實(shí)現(xiàn)該功能。為了解決上述問題，Angular 路由模塊為我們提供了 routerLinkActive 指令，該指令的使用示例如下：

  1. <nav>
  2.   <a routerLink="/settings" routerLinkActive="active">Home</a>
  3.   <a routerLink="/settings/password" routerLinkActive="active">Change password</a>
  4.   <a routerLink="/settings/profile" routerLinkActive="active">Profile Settings</a>
  5. </nav>

通過使用 routerLinkActive 指令，當(dāng) a 元素對應(yīng)的路由處于激活狀態(tài)時，active 類將會自動添加到 a 元素上。

最后，我們來簡單介紹一下 Router API。

Router API

我們可以通過路由還提供的 API 實(shí)現(xiàn)與 routerLink 相同的功能。要使用 Router API，我們需要在組件類中注入 Router 對象，具體如下：

  1. import { Component } from '@angular/core';
  2. import { Router } from '@angular/router';
  5. @Component({
  6.   selector: 'app-root',
  7.   template: `
  8.     <div class="app">
  9.       <h3>Our app</h3>
  10.       <router-outlet></router-outlet>
  11.     </div>
  12.   `
  13. })
  14. export class AppComponent {
  15.   constructor(private router: Router) {}
  16. }

組件類中注入的 router 對象中有一個 navigate() 方法，該方法支持的參數(shù)類型與 routerLink 指令一樣，當(dāng)調(diào)用該方法后，頁面將會自動跳轉(zhuǎn)到對應(yīng)的路由地址。具體使用示例如下：

  1. import { Component, OnInit } from '@angular/core';
  2. import { Router } from '@angular/router';
  5. @Component({
  6.   selector: 'app-root',
  7.   template: `
  8.     <div class="app">
  9.       <h3>Our app</h3>
  10.       <router-outlet></router-outlet>
  11.     </div>
  12.   `
  13. })
  14. export class AppComponent implements OnInit {
  15.   constructor(private router: Router) {}
  16.   ngOnInit() {
  17.     setTimeout(() => {
  18.       this.router.navigate(['/settings']);
  19.     }, 5000);
  20.   }
  21. }

若以上代碼成功運(yùn)行，用戶界面將在 5 秒后被重定向到 /settings 頁面。這個方法非常有用，例如當(dāng)檢測到用戶尚未登錄時，自動重定向到登錄頁面。

另一個使用示例是演示頁面跳轉(zhuǎn)時如何傳遞數(shù)據(jù)，具體如下：

  1. import { Component, OnInit } from '@angular/core';
  2. import { Router } from '@angular/router';
  5. @Component({
  6.   selector: 'app-root',
  7.   template: `
  8.     <div class="app">
  9.       <h3>Users</h3>
  10.       <div *ngFor="let user of users">
  11.         <user-component 
  12.           [user]="user"
  13.           (select)="handleSelect($event)">
  14.         </user-component>
  15.       </div>
  16.       <router-outlet></router-outlet>
  17.     </div>
  18.   `
  19. })
  20. export class AppComponent implements OnInit {
  21.   users: Username[] = [
  22.     { name: 'toddmotto', id: 0 },
  23.     { name: 'travisbarker', id: 1 },
  24.     { name: 'tomdelonge', id: 2 }
  25.   ];
  27.   
  28.   constructor(private router: Router) {}
  30.   
  31.   handleSelect(event) {
  32.     this.router.navigate(['/profile', event.name]);
  33.   }
  34. }

Angular 路由的功能非常強(qiáng)大，既可以使用指令方式也可以使用命令式 API，希望本文可以幫助你盡快入門，若要進(jìn)一步了解路由詳細(xì)信息，請訪問 - Angular Router 官文文檔。

我有話說

除了使用 navigate() 方法外還有沒有其它方法可以實(shí)現(xiàn)頁面導(dǎo)航？

Angular Router API 為我們提供了 navigate() 和 navigateByUrl() 方法來實(shí)現(xiàn)頁面導(dǎo)航。那為什么會有兩個不同的方法呢？

使用 router.navigateByUrl() 方法與直接改變地址欄上的 URL 地址一樣，我們使用了一個新的 URL 地址。然而 router.navigate() 方法基于一系列輸入?yún)?shù)，產(chǎn)生一個新的 URL 地址。為了更好的區(qū)分它們之間的差異，我們來看個例子，假設(shè)當(dāng)前的 URL 地址是：

  1. /inbox/11/message/22(popup:compose)

當(dāng)我們調(diào)用 router.navigateByUrl('/inbox/33/message/44') 方法后，此時的 URL 地址將變成 /inbox/33/message/44 。但如果我們是調(diào)用 router.navigate('/inbox/33/message/44') 方法，當(dāng)前的 URL 地址將變成 /inbox/33/message/44(popup:compose) 。

參考資源

以上內(nèi)容是否對您有幫助：
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號