跳到主要内容
版本:v6

Ionic 页面生命周期

本指南介绍了在使用 Ionic 和 Angular 构建的应用中页面生命周期的工作方式。

说明 Ionic 页面生命周期事件及其顺序的流程图。

Angular 生命周期事件

Ionic 融合了 Angular 提供的生命周期事件。你将会最常使用到的两个 Angular 事件是:

事件名称描述
ngOnInit在组件初始化时触发一次。此事件可用于初始化局部成员以及调用只需执行一次的服务。
ngOnDestroy在 Angular 销毁视图之前触发。适用于清理工作,如取消订阅 observables。

更多关于 Angular 组件生命周期事件的信息,请访问其组件生命周期文档

备注

使用 ion-navion-router-outlet 的组件不应使用 OnPush 变更检测策略。这样做会阻止 ngOnInit 等生命周期钩子的触发。此外,异步状态变更也可能无法正确渲染。

Ionic 页面事件

除了 Angular 生命周期事件之外,Ionic Angular 还提供了一些额外的事件供你使用:

事件名称描述
ionViewWillEnter当路由目标组件即将以动画方式进入视图时触发。
ionViewDidEnter当路由目标组件已完成动画进入时触发。
ionViewWillLeave当路由来源组件即将以动画方式离开时触发。
ionViewDidLeave当路由来源组件已完成动画离开时触发。

这些生命周期仅在被路由直接映射的组件上调用。这意味着如果 /pageOne 映射到 PageOneComponent,那么 Ionic 生命周期将在 PageOneComponent 上调用,但不会在 PageOneComponent 可能渲染的任何子组件上调用。

ionViewWillEnterionViewDidEnter 的区别在于它们的触发时机。前者在 ngOnInit 之后、页面过渡动画开始之前触发,而后者则在过渡动画结束后直接触发。

对于 ionViewWillLeaveionViewDidLeaveionViewWillLeave 在当前页面过渡动画开始之前调用,而 ionViewDidLeave 直到新页面成功过渡进入后才会被调用(在新页面的 ionViewDidEnter 触发之后)。

演示当页面过渡发生时控制台中 Ionic 页面生命周期事件的动画 GIF。

Ionic 如何处理页面的生命周期

Ionic 有自己的路由出口,称为 <ion-router-outlet />。该出口扩展了 Angular 的 <router-outlet />,并增加了一些额外功能,以提供更好的移动设备体验。

当应用被包裹在 <ion-router-outlet /> 中时,Ionic 对导航的处理略有不同。当你导航到一个新页面时,Ionic 会将旧页面保留在现有的 DOM 中,但将其从视图中隐藏并过渡到新页面。这样做有两个原因:

  1. 我们可以保持旧页面的状态(屏幕上的数据、滚动位置等)
  2. 我们可以提供更平滑的返回过渡效果,因为页面已经存在,无需重新创建。

页面只有在被"弹出"时才会从 DOM 中移除,例如通过按 UI 中的返回按钮或浏览器的返回按钮。

由于这种特殊处理,ngOnInitngOnDestroy 方法可能不会在你通常认为应该触发的时候触发。

ngOnInit 仅在页面被全新创建时触发,而不是在导航回页面时触发。例如,在标签界面中切换页面,每个页面的 ngOnInit 方法只会被调用一次,而不会在后续访问时再调用。ngOnDestroy 仅在页面被"弹出"时触发。

路由守卫

在 Ionic 3 中,有一些额外的生命周期方法可用于控制页面何时可以进入(ionViewCanEnter)和离开(ionViewCanLeave)。这些方法可用于保护页面免受未授权用户的访问,以及在你不希望用户离开时将其留在页面上(例如在填写表单时)。

这些方法在 Ionic 4 中被移除,取而代之的是使用 Angular 的路由守卫。

路由守卫有助于确定是否可以针对路由执行特定操作。它们是实现特定接口的类。CanActivateCanDeactivate 接口可用于实现与已移除的 ionViewCanEnterionViewCanLeave 事件相同的逻辑。

@Injectable()
export class AuthGuard implements CanActivate {
constructor(private authService: AuthService) {}

canActivate(route: ActivatedRouteSnapshot, state: RouterStateSnapshot) {
return this.authService.isAuthenticated();
}
}

要使用此守卫,请将其添加到路由定义中的相应参数:

{ path: 'settings', canActivate: [AuthGuard], loadChildren: '...',  }

关于如何使用路由守卫的更多信息,请访问 Angular 的路由文档

各生命周期方法的指导建议

以下是每个生命周期事件使用场景的一些建议。

  • ngOnInit - 初始化你的组件,并从服务中加载不需要在每次后续访问时刷新的数据。
  • ionViewWillEnter - 由于 ionViewWillEnter 在每次导航到视图时都会被调用(无论是否已初始化),因此它是从服务加载数据的好方法。但是,如果你的数据在动画期间返回,可能会启动大量 DOM 操作,从而导致动画卡顿。
  • ionViewDidEnter - 如果你发现在加载数据时使用 ionViewWillEnter 存在性能问题,你可以改用 ionViewDidEnter 来进行数据调用。但是,此事件在页面被用户看到之后才会触发,因此你可能需要使用加载指示器或骨架屏,以避免内容在过渡完成后出现不自然的闪烁。
  • ionViewWillLeave - 可用于清理工作,如取消订阅 observables。由于 ngOnDestroy 可能在离开当前页面时不会触发,如果你不希望某些逻辑在屏幕不可见时仍处于活动状态,请在此处放置清理代码。
  • ionViewDidLeave - 当此事件触发时,表示新页面已经完全过渡进入,因此你可以在此处放置你通常不会在视图可见时执行的逻辑。
  • ngOnDestroy - 用于存放你不希望在 ionViewWillLeave 中清理的页面清理逻辑。