React 生命周期

本指南讨论如何在 Ionic React 应用中使用 Ionic Lifecycle 事件。

🌐 This guide discusses how to use the Ionic Lifecycle events in an Ionic React application.

Ionic 生命周期方法

🌐 Ionic Lifecycle Methods

Ionic 提供了一些可以在应用中使用的生命周期方法：

🌐 Ionic provides a few lifecycle methods that you can use in your apps:

事件名称	描述
`ionViewWillEnter`	当要切换到的组件即将动画显示时触发。
`ionViewDidEnter`	当要切换到的组件动画已完成时触发。
`ionViewWillLeave`	当要切换离开的组件即将动画时触发。
`ionViewDidLeave`	当要切换离开的组件动画已完成时触发。

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

🌐 These lifecycles are only called on components directly mapped by a router. This means if /pageOne maps to PageOneComponent, then Ionic lifecycles will be called on PageOneComponent but will not be called on any child components that PageOneComponent may render.

访问这些方法的方式取决于你使用的是基于类的组件还是函数组件。我们在下面介绍这两种方法。

🌐 The way you access these methods varies based on if you are using class-based components or functional components. We cover both methods below.

基于类的组件中的生命周期方法

🌐 Lifecycle Methods in Class-Based Components

要在基于类的组件中使用 Ionic 生命周期方法，必须像这样将你的组件封装在 withIonLifeCycle 高阶组件（HOC）中：

🌐 to use the Ionic Lifecycle methods in a class-based component, you must wrap your component with the withIonLifeCycle higher order component (HOC) like so:

export default withIonLifeCycle(HomePage);

note

withIonLifeCycle 是从 @ionic/react 导入的

然后你可以在你的类组件上创建相应的生命周期方法，当事件发生时，高阶组件会调用该方法。下面是包含每个生命周期方法实现的完整组件：

🌐 You can then create the appropriate lifecycle method on your class component, and the HOC calls that method when the event happens. Below is the entire component with each of the lifecycle methods implemented:

import React from 'react';
import { IonHeader, IonPage, IonToolbar, IonTitle, IonContent, withIonLifeCycle } from '@ionic/react';

class HomePage extends React.Component {
  ionViewWillEnter() {
    console.log('ionViewWillEnter event fired');
  }

  ionViewWillLeave() {
    console.log('ionViewWillLeave event fired');
  }

  ionViewDidEnter() {
    console.log('ionViewDidEnter event fired');
  }

  ionViewDidLeave() {
    console.log('ionViewDidLeave event fired');
  }

  render() {
    return (
      <IonPage>
        <IonHeader>
          <IonToolbar>
            <IonTitle>Home</IonTitle>
          </IonToolbar>
        </IonHeader>
        <IonContent></IonContent>
      </IonPage>
    );
  }
}

export default withIonLifeCycle(HomePage);

功能组件中的生命周期方法

🌐 Lifecycle Methods in Functional Components

Ionic React 为每个生命周期方法导出钩子，你可以在函数组件中使用。每个钩子都接受在事件触发时你想调用的方法。

🌐 Ionic React exports hooks for each of the lifecycle methods that you can use in your functional components. Each of the hooks takes the method you want called when the event fires.

import {
  IonContent,
  IonHeader,
  IonTitle,
  IonToolbar,
  useIonViewDidEnter,
  useIonViewDidLeave,
  useIonViewWillEnter,
  useIonViewWillLeave,
} from '@ionic/react';
import React from 'react';

const HomePage: React.FC = () => {
  useIonViewDidEnter(() => {
    console.log('ionViewDidEnter event fired');
  });

  useIonViewDidLeave(() => {
    console.log('ionViewDidLeave event fired');
  });

  useIonViewWillEnter(() => {
    console.log('ionViewWillEnter event fired');
  });

  useIonViewWillLeave(() => {
    console.log('ionViewWillLeave event fired');
  });

  return (
    <IonPage>
      <IonHeader>
        <IonToolbar>
          <IonTitle>Home</IonTitle>
        </IonToolbar>
      </IonHeader>
      <IonContent></IonContent>
    </IonPage>
  );
};

export default HomePage;

note

函数组件不需要像类组件那样用 withIonLifeCycle 高阶组件封装。

开发者也可以选择性地向每个生命周期钩子传递响应式依赖。这些依赖随后会传递给底层的 React useEffect 钩子:

🌐 Developers can also optionally pass reactive dependencies to each lifecycle hook. These are then passed to the underlying React useEffect hook:

const [data, setData] = useState('foo');

useIonViewDidEnter(() => {
  console.log('ionViewDidEnter event fired');
}, [data]);

React 生命周期方法

🌐 React LifeCycle Methods

React 中的所有生命周期方法（componentDidMount、componentWillUnmount 等）也可供你使用。然而，由于 Ionic React 管理页面的生命周期，某些事件可能不会按你期望的方式触发。例如，componentDidMount 会在页面首次显示时触发，但如果你导航离开该页面，Ionic 可能会将页面保留在 DOM 中，之后再次访问该页面时可能不会再次调用 componentDidMount。这种情况是 Ionic 生命周期方法存在的主要原因，它仍然为你提供了一种在视图进入和退出时调用逻辑的方法，即使原生框架的事件可能不会触发。

🌐 All the lifecycle methods in React (componentDidMount, componentWillUnmount, etc..) are available for you to use as well. However, since Ionic React manages the lifetime of a page, certain events might not fire when you expect them to. For instance, componentDidMount fires the first time a page is displayed, but if you navigate away from the page Ionic might keep the page around in the DOM, and a subsequent visit to the page might not call componentDidMount again. This scenario is the main reason the Ionic lifecycle methods exist, to still give you a way to call logic when views enter and exit when the native framework's events might not fire.

每种生命周期方法的指南

🌐 Guidance for Each LifeCycle Method

以下是有关每个生命周期事件用例的一些提示。

🌐 Below are some tips on use cases for each of the life cycle events.

ionViewWillEnter - 由于每次导航到视图时都会调用 ionViewWillEnter（无论是否已初始化），它是从服务加载数据的一个好方法。
ionViewDidEnter - 如果在使用 ionViewWillEnter 加载数据时遇到性能问题，你可以改为在 ionViewDidEnter 中进行数据调用。然而，该事件直到页面对用户可见之后才会触发，因此你可能需要使用加载指示器或骨架屏，以防内容在过渡完成后不自然地闪现。
ionViewWillLeave - 可以用于清理，例如取消订阅数据源。由于在从当前页面导航时 componentWillUnmount 可能不会触发，如果你不希望在屏幕不在视图中时它处于活动状态，请将你的清理代码放在这里。
ionViewDidLeave - 当此事件触发时，你知道新页面已完全转换，因此当视图可见时你通常不会执行的任何逻辑都可以转到此处。

在页面之间传递状态

🌐 Passing state between pages

由于 Ionic React 管理页面的生命周期，用户在浏览应用时，之前页面的状态可能会更新。这可能会影响使用 React 的 useEffect 或 React Router 的 useLocation 确定的状态。例如，如果 PageA 调用 useLocation，当用户从 PageA 导航到 PageB 时，useLocation 的状态将会改变。

🌐 Since Ionic React manages the lifetime of a page, state on previous pages may update as users navigate your application. This can impact state that is determined using useEffect from React or useLocation from React Router. For example, if PageA calls useLocation, the state of useLocation will change when the user navigates from PageA to PageB.

开发者应进行适当的检查，以确保先前的页面仅访问定义的状态。

🌐 Developers should include the appropriate checks to ensure that previous pages only access defined states.

例如，如果 testObject 未定义，以下代码将报错：{ state.testObject.childKey }

🌐 For example, the following code will error if testObject is not defined: { state.testObject.childKey }

相反，开发者应当仅在 testObject 被定义时访问 childKey：{ state.testObject?.childKey }

🌐 Instead, developers should access childKey only if testObject is defined: { state.testObject?.childKey }

Ionic 生命周期方法​

基于类的组件中的生命周期方法​

功能组件中的生命周期方法​

React 生命周期方法​

每种生命周期方法的指南​

在页面之间传递状态​

目录