生命周期

更新时间：2024-10-12 10:51:00

了解页面生命周期与状态，应用生命周期

生命周期图

页面生命周期

onInit

监听页面初始化。当页面完成初始化时调用，只触发一次

onReady

监听页面创建完成。当页面完成创建可以显示时触发，只触发一次

参数

无

onShow

监听页面显示。当进入页面时，或者当前页面被弹框覆盖时触发

参数

无

onHide

监听页面隐藏。当页面跳转离开时，或者覆盖当前页面的弹框消失时触发

参数

无

onDestroy

监听页面退出。当页面跳转离开（不进入导航栈）时触发

参数

无

onBackPress()

监听返回动作。当用户执行返回操作时触发。只有当前页面配置了 followHand : disable，该接口才生效。

参数

无

返回值

类型	描述
Boolean	返回 true 表示页面自己处理返回逻辑，返回 false 表示使用默认的返回逻辑，不返回值会作为 false 处理；注意：该函数不支持声明为异步函数（即：使用`async`标识），因为返回值代表界面要立即响应用户操作；

onRefresh

监听页面重新打开。

1.当页面在 manifest 中 launchMode 标识为'singleTask'时，仅会存在一个目标页面实例，用户多次打开目标页面时触发此函数。
该回调中参数为重新打开该页面时携带的参数。
详见页面启动模式

参数

参数名	类型	描述
query	Object	通过 deeplink、router.push 等接口传入的 uri 中 query 解析成的对象，或者 router.push 等接口传入的 params 对象

onKey

监听按键响应。当按键被触发时回调

参数

参数名	类型	描述
event	Object	被触发的按键事件

event 参数

参数名	类型	描述
keyCode	Number	按下的键位，0：下键(电源键)，1：上键
keyAction	Number	按下或弹起的动作 0：按下 1：短按弹起 2：长按弹起
repeatCount	Number	连续按的次数，按键在长按的时候，会连续产生多个按下事件，这个时候第一个按下事件的 repeatCount 为 0，之后的按下事件 repeatCount 会递增。

示例代码：

onKey(event) {
  console.log(`key pressed! ${JSON.stringify(event)}`);
  console.info(`触发页面生命周期 onKey`)
}

复制代码

onConfigurationChanged

监听系统语言改变

参数

参数名	类型	描述
event	Object	应用配置发生变化的事件

event 参数：

参数名	类型	描述
type	String	应用配置发生变化的原因类型，支持的 type 值如下所示

event 中type 现在支持的参数值如下：

参数值	描述
locale	应用语言、地区变化而发生改变

示例代码：

onConfigurationChanged(evt) {
  if (event && event.type && event.type === 'locale') {
    console.log('locale or language changed!')
  }
}

复制代码

onPalmOver

监听手掌覆盖事件

参数

无

返回值

true 表示不将事件继续传递给 launcher，其他值或者不返回都会将事件继续传递给 launcher。

示例代码：

onPalmOver(evt) {
  console.info(`大手掌事件 onPalmOver`)
  return true;
}

复制代码

页面的生命周期接口的调用顺序

打开页面 A：onInit() -> onReady() -> onShow()
在页面 A 打开页面 B：onHide()
从页面 B 返回页面 A：onShow()

自定义组件的生命周期

自定义组件，指的是通过 import 标签引入的 ViewModel 组件

属性	类型	参数	返回值	描述	触发时机
onInit	Function	无	无	监听初始化	当数据驱动化完成时触发
onReady	Function	无	无	监听模板创建完成	当模板创建完成时触发
onDestroy	Function	无	无	监听组件销毁	当销毁时触发