Angular入门到精通系列教程（12）- 路由（Routing）

╰半夏微凉° 2023-01-10 15:57 148阅读 0赞

### 文章目录 ###

*  1. 摘要
 *  2. 路由（Router）基本用法
 *   *  2.1. 准备
     *  2.2. 注册路由
     *  2.3. html中的用法
     *  2.4. ts 代码中的用法
 *  3. 接收参数
 *   *  3.1. 路径中的参数
     *  3.2. 参数（QueryParameter）中的参数
 *  4. URL路径显示格式
 *  5. 部署中遇到的问题
 *  6. 总结

*  1. 摘要
 *  2. 路由（Router）基本用法
    
     *  2.1. 准备
     *  2.2. 注册路由
     *  2.3. html中的用法
     *  2.4. ts 代码中的用法
 *  3. 接收参数
    
     *  3.1. 路径中的参数
     *  3.2. 参数（QueryParameter）中的参数
 *  4. URL路径显示格式
 *  5. 部署中遇到的问题
 *  6. 总结

> 环境:
> 
>  *  Angular CLI: 11.0.6
>  *  Angular: 11.0.7
>  *  Node: 12.18.3
>  *  npm : 6.14.6
>  *  IDE: Visual Studio Code

# 1. 摘要 #

简单来说地址栏中，不同的地址（URL）对应不同的页面，这就是路由。同时，点击浏览器的前进和后退按钮，浏览器就会在你的浏览历史中向前或向后导航，这也是基于路由。

在 Angular 里面，Router 是一个独立的模块，定义在 @angular/router 模块中，

1.  Router 可以配合 NgModule 进行模块的延迟加载（懒加载）、预加载操作（参考《Angular入门到精通系列教程（11）- 模块(NgModule)，延迟加载模块》）；
2.  Router 会管理组件的生命周期，它会负责创建、销毁组件。

对于一个新的基于AngularCLI的项目，初始化时可以通过选项，将AppRoutingModule默认加入到app.component.ts中。

# 2. 路由（Router）基本用法 #

## 2.1. 准备 ##

我们首先创建2个页面，用于说明路由的使用：

ng g c page1
    ng g c page2

使用上面AnuglarCLI命令，创建Page1Component, Page2Component 2个组件。

## 2.2. 注册路由 ##

//src\app\app-routing.module.ts
    const routes: Routes = [
      { 
        path: 'page1',
        component: Page1Component
      },
      { 
        path: 'page2',
        component: Page2Component
      },
    ];
    
    @NgModule({ 
      imports: [RouterModule.forRoot(routes)],
      exports: [RouterModule],
    })
    export class AppRoutingModule { }

可以看到，简单的路由注册，只需要path和component2个属性，分别定义路由的相对路径，以及这个路由的响应组件。

## 2.3. html中的用法 ##

在html模板中，直接使用routerLink属性，标识为angular的路由。执行代码，可以看到 Page1和Page2 两个超链接，点击可以看到地址栏地址改为http://localhost:4200/page2或http://localhost:4200/page1， 页面内容在page1和page2中切换

## 2.4. ts 代码中的用法 ##

有时候，需要根据ts中的业务逻辑，进行跳转。ts中，需要注入Router实例，如

constructor(private router: Router) { }

跳转代码：

// 跳转到 /page1
      this.router.navigate(['/page1']);
    
      // 跳转到 /page1/123
      this.router.navigate(['/page1', 123]);

# 3. 接收参数 #

## 3.1. 路径中的参数 ##

一般来说，我们把参数作为url中的一段，如/users/1, 代表查询id是1的用户，路由定义为"/users/id" 这种风格。

针对我们的简单页面，比如我们的page1页面可以传id参数，那么我们需要修改我们的routing为：

const routes: Routes = [
      { 
        path: 'page1/:id',    //接收id参数
        component: Page1Component,
      },
      { 
        // 实现可选参数的小技巧。 这个routing处理没有参数的url
        path: 'page1',        
        redirectTo: 'page1/',   // 跳转到'page1/:id'
      },
      { 
        path: 'page2',
        component: Page2Component,
      },
    ];

ts代码读取参数时， 首先需要注入ActivatedRoute，代码如下：

constructor(private activatedRoute: ActivatedRoute) { }
    
    ngOnInit(): void { 
      this.activatedRoute.paramMap.subscribe((params) => { 
        console.log('Parameter id: ', params.get('id'));
    
        // 地址 http://localhost:4200/page1/33 
        // 控制台输出：Query Parameter name: 33
    
        // 地址 http://localhost:4200/page1/ 
        // 控制台输出：Query Parameter name: (实际结果为undefined)
      });
    }

## 3.2. 参数（QueryParameter）中的参数 ##

参数还有另外一种写法，如http://localhost:4200/?name=cat, 即URL地址后，加一个问号’?’, 之后再加参数名和参数值（‘name=cat’）。这种称为查询参数(QueryParameter)。

取这查询参数时，和之前的路由参数类似，只是paramMap改为queryParamMap，代码如下：

this.activatedRoute.queryParamMap.subscribe((params) => { 
      console.log('Query Parameter name: ', params.get('name'));
    
      // 地址 http://localhost:4200/page1?name=cat
      // 控制台输出：Query Parameter name: cat
    
      // 地址 http://localhost:4200/page1/
      // 控制台输出：Query Parameter name: (实际结果为undefined)
    });

# 4. URL路径显示格式 #

不同于传统的纯静态（html）站点，angular中的url不是对应一个真实的文件（页面），因为anuglar接管的路由（Routing）处理，来决定显示那个Component给终端用户。为了针对不同的场景，angular的URL路径显示格式有2中：

1.  http://localhost:4200/page1/123
2.  http://localhost:4200/\#/page1/123

默认是第一种，不加\#的。如果需要，可以在app-routing.ts中，加入`useHash: true`, 如：

// app-routing.ts
    @NgModule({ 
      imports: [RouterModule.forRoot(routes, {  useHash: true })],
      exports: [RouterModule],
    })

# 5. 部署中遇到的问题 #

同样，因为anuglar接管的路由（Routing）处理，所以部署时，部署到iis, nginx等等的服务器，都会有不同的技巧（要求），详细参考：  
https://github.com/angular-ui/ui-router/wiki/Frequently-Asked-Questions\#how-to-configure-your-server-to-work-with-html5mode

# 6. 总结 #

1.  angular默认不支持可选路由（e.g. /user/:id?),但是我们可以定义2个路由，指向同一个Component来实现这个，达到代码复用；（或者使用redirectTo）
2.  可以使用useHash参数，实现augular路径前加一个\#；
3.  读取参数时，都需要subscribe订阅一下，不能直接读取。
4.  打包后部署问题，查看官方wifi （https://github.com/angular-ui/ui-router/wiki/Frequently-Asked-Questions\#how-to-configure-your-server-to-work-with-html5mode）

> \---------------- END ----------------

> ======================