Angular 中文文档

# 路由转场动画

路由使用户能够在应用程序中的不同路由之间导航。

# 前提条件

对下列概念有基本的理解：

  • Angular 动画简介

  • 转场与触发器

  • 可复用动画

# 启用路由过渡动画

路由能让用户在应用中的不同路由之间导航。当用户从一个路由导航到另一个路由时，Angular 路由器会把这个 URL 映射到一个相关的组件，并显示其视图。为这种路由转换添加动画，将极大地提升用户体验。

Angular 路由器天生带有高级动画功能，它可以让你为在路由变化时为视图之间设置转场动画。要想在路由切换时生成动画序列，你需要首先定义出嵌套的动画序列。从宿主视图的顶层组件开始，在这些内嵌视图的宿主组件中嵌套动画。

要启用路由转场动画，需要做如下步骤：

  • 为应用导入路由模块，并创建一个路由配置来定义可能的路由。

  • 添加路由器出口，来告诉 Angular 路由器要把激活的组件放在 DOM 中的什么位置。

  • 定义动画。

让我们以两个路由之间的导航过程来解释一下路由转场动画，Home和 About分别与 HomeComponent和 AboutComponent的视图相关联。所有这些组件视图都是顶层视图的子节点，其宿主是 AppComponent。接下来将实现路由器过渡动画，该动画会在出现新视图时向右滑动，并当在两个路由之间导航时把旧视图滑出。

Animations in action

# 路由配置

首先，使用 RouterModule类提供的方法来配置一组路由。该路由配置会告诉路由器该如何导航。

使用 RouterModule.forRoot方法来定义一组路由。同时，把其返回值添加到主模块 AppModule的 imports数组中。

注意：在根模块 AppModule中使用 RouterModule.forRoot方法来注册一些顶层应用路由和提供者。对于特性模块，则改用 RouterModule.forChild方法。

下列配置定义了应用程序中可能的路由。

src/app/app.module.ts

import { NgModule } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { BrowserAnimationsModule } from '@angular/platform-browser/animations';
import { RouterModule } from '@angular/router';
import { AppComponent } from './app.component';
import { OpenCloseComponent } from './open-close.component';
import { OpenClosePageComponent } from './open-close-page.component';
import { OpenCloseChildComponent } from './open-close.component.4';
import { ToggleAnimationsPageComponent } from './toggle-animations-page.component';
import { StatusSliderComponent } from './status-slider.component';
import { StatusSliderPageComponent } from './status-slider-page.component';
import { HeroListPageComponent } from './hero-list-page.component';
import { HeroListGroupPageComponent } from './hero-list-group-page.component';
import { HeroListGroupsComponent } from './hero-list-groups.component';
import { HeroListEnterLeavePageComponent } from './hero-list-enter-leave-page.component';
import { HeroListEnterLeaveComponent } from './hero-list-enter-leave.component';
import { HeroListAutoCalcPageComponent } from './hero-list-auto-page.component';
import { HeroListAutoComponent } from './hero-list-auto.component';
import { HomeComponent } from './home.component';
import { AboutComponent } from './about.component';
import { InsertRemoveComponent } from './insert-remove.component';
import { QueryingComponent } from './querying.component';

@NgModule({
  imports: [
    BrowserModule,
    BrowserAnimationsModule,
    RouterModule.forRoot([
      { path: '', pathMatch: 'full', redirectTo: '/enter-leave' },
      {
        path: 'open-close',
        component: OpenClosePageComponent,
        data: { animation: 'openClosePage' }
      },
      {
        path: 'status',
        component: StatusSliderPageComponent,
        data: { animation: 'statusPage' }
      },
      {
        path: 'toggle',
        component: ToggleAnimationsPageComponent,
        data: { animation: 'togglePage' }
      },
      {
        path: 'heroes',
        component: HeroListPageComponent,
        data: { animation: 'filterPage' }
      },
      {
        path: 'hero-groups',
        component: HeroListGroupPageComponent,
        data: { animation: 'heroGroupPage' }
      },
      {
        path: 'enter-leave',
        component: HeroListEnterLeavePageComponent,
        data: { animation: 'enterLeavePage' }
      },
      {
        path: 'auto',
        component: HeroListAutoCalcPageComponent,
        data: { animation: 'autoPage' }
      },
      {
        path: 'insert-remove',
        component: InsertRemoveComponent,
        data: { animation: 'insertRemovePage' }
      },
      {
        path: 'querying',
        component: QueryingComponent,
        data: { animation: 'queryingPage' }
      },
      {
        path: 'home',
        component: HomeComponent,
        data: { animation: 'HomePage' }
      },
      {
        path: 'about',
        component: AboutComponent,
        data: { animation: 'AboutPage' }
      },
    ])
  ],

home和 about路径分别关联着 HomeComponent和 AboutComponent视图。该路由配置告诉 Angular 路由器当导航匹配了相应的路径时，就实例化 HomeComponent和 AboutComponent视图。

每个路由定义中的 data属性也定义了与此路由有关的动画配置。当路由变化时，data属性的值就会传给 AppComponent。

注意：这个 data中的属性名可以是任意的。比如，上面例子中使用的名字 animation就是随便起的。

# 路由出口

配置好路由之后，还要告诉 Angular 路由器当路由匹配时，要把视图渲染到那里。你可以通过在根组件 AppComponent的模板中插入一个 <router-outlet>容器来指定路由出口的位置。

ChildrenOutletContexts包含有关插座和激活路由的信息。我们可以用每个 Route的 data属性来为我们的路由转换设置动画。

src/app/app.component.html

<div [@routeAnimations]="getRouteAnimationData()">
  <router-outlet></router-outlet>
</div>

AppComponent中定义了一个可以检测视图何时发生变化的方法，该方法会基于路由配置的 data属性值，将动画状态值赋值给动画触发器（@routeAnimation）。下面就是一个 AppComponent中的范例方法，用于检测路由在何时发生了变化。

src/app/app.component.ts

constructor(private contexts: ChildrenOutletContexts) {}

getRouteAnimationData() {
  return this.contexts.getContext('primary')?.route?.snapshot?.data?.['animation'];
}

这里的 getRouteAnimationData()方法会获取这个 outlet 指令的值（通过 #outlet="outlet"）。它会根据当前活动路由的自定义数据返回一个表示动画状态的字符串值。可以用这个数据来控制各个路由之间该执行哪个转场。

# 动画定义

动画可以直接在组件中定义。对于此范例，我们会在独立的文件中定义动画，这让我们可以复用这些动画。

下面的代码片段定义了一个名叫 slideInAnimation的可复用动画。

src/app/animations.ts

export const slideInAnimation =
  trigger('routeAnimations', [
    transition('HomePage <=> AboutPage', [
      style({ position: 'relative' }),
      query(':enter, :leave', [
        style({
          position: 'absolute',
          top: 0,
          left: 0,
          width: '100%'
        })
      ]),
      query(':enter', [
        style({ left: '-100%' })
      ]),
      query(':leave', animateChild()),
      group([
        query(':leave', [
          animate('300ms ease-out', style({ left: '100%' }))
        ]),
        query(':enter', [
          animate('300ms ease-out', style({ left: '0%' }))
        ]),
      ]),
    ]),
    transition('* <=> *', [
      style({ position: 'relative' }),
      query(':enter, :leave', [
        style({
          position: 'absolute',
          top: 0,
          left: 0,
          width: '100%'
        })
      ]),
      query(':enter', [
        style({ left: '-100%' })
      ]),
      query(':leave', animateChild()),
      group([
        query(':leave', [
          animate('200ms ease-out', style({ left: '100%', opacity: 0 }))
        ]),
        query(':enter', [
          animate('300ms ease-out', style({ left: '0%' }))
        ]),
        query('@*', animateChild())
      ]),
    ])
  ]);

该动画定义做了如下事情：

  • 定义两个转场。每个触发器都可以定义多个状态和多个转场

  • 调整宿主视图和子视图的样式，以便在转场期间，控制它们的相对位置

  • 使用 query()来确定哪个子视图正在进入或离开宿主视图

路由的变化会激活这个动画触发器，并应用一个与该状态变更相匹配的转场

注意：这些转场状态必须和路由配置中定义的 data属性的值相一致。

通过将可复用动画 slideInAnimation添加到 AppComponent的 animations元数据中，可以让此动画定义能用在你的应用中。

src/app/app.component.ts

@Component({
  selector: 'app-root',
  templateUrl: 'app.component.html',
  styleUrls: ['app.component.css'],
  animations: [
    slideInAnimation
  ]
})

# 为宿主组件和子组件添加样式

在转场期间，新视图将直接插入在旧视图后面，并且这两个元素会同时出现在屏幕上。要防止这种行为，就要修改宿主视图，改用相对定位。然后，把已移除或已插入的子视图改用绝对定位。在这些视图中添加样式，就可以让容器就地播放动画，并防止某个视图影响页面中其它视图的位置。

src/app/animations.ts (excerpt)

trigger('routeAnimations', [
  transition('HomePage <=> AboutPage', [
    style({ position: 'relative' }),
    query(':enter, :leave', [
      style({
        position: 'absolute',
        top: 0,
        left: 0,
        width: '100%'
      })
    ]),

# 查询视图的容器

使用 query()方法可以找出当前宿主组件中的动画元素。query(":enter")语句会返回已插入的视图，query(":leave")语句会返回已移除的视图。

假设你正在从 Home转场到 About，Home => About。

src/app/animations.ts (excerpt)

query(':enter', [
    style({ left: '-100%' })
  ]),
  query(':leave', animateChild()),
  group([
    query(':leave', [
      animate('300ms ease-out', style({ left: '100%' }))
    ]),
    query(':enter', [
      animate('300ms ease-out', style({ left: '0%' }))
    ]),
  ]),
]),
transition('* <=> *', [
  style({ position: 'relative' }),
  query(':enter, :leave', [
    style({
      position: 'absolute',
      top: 0,
      left: 0,
      width: '100%'
    })
  ]),
  query(':enter', [
    style({ left: '-100%' })
  ]),
  query(':leave', animateChild()),
  group([
    query(':leave', [
      animate('200ms ease-out', style({ left: '100%', opacity: 0 }))
    ]),
    query(':enter', [
      animate('300ms ease-out', style({ left: '0%' }))
    ]),
    query('@*', animateChild())
  ]),
])

在设置了视图的样式之后，动画代码会执行如下操作：

  • query(':enter style({ left: '-100%'})会匹配添加的视图，并通过将其定位在最左侧来隐藏这个新视图。

  • 在正在离开的视图上调用 animateChild()，来运行其子动画。

  • 使用group()函数使内部动画并行运行。

  • 在 group() 函数中：

  • 查询已移除的视图，并让它从右侧滑出。

  • 使用缓动函数和持续时间定义的动画，让这个新视图滑入。

此动画将导致 about视图从左侧划入。

  • 当主动画完成之后，在这个新视图上调用 animateChild()方法，以运行其子动画。

你现在有了一个基本的路由动画，可以在从一个视图路由到另一个视图时播放动画。

# 关于 Angular 动画的更多知识

你可能还对下列内容感兴趣：

  • Angular 动画简介

  • 转场与触发器

  • 复杂动画序列

  • 可复用动画

Last Updated: 5/16/2023, 7:35:10 PM

← 介绍 →