微搭支持页面、应用级别的生命周期函数,当对应的生命周期函数触发时,便会自动执行函数下已配置的事件动作或自定义方法。
页面生命周期
页面生命周期说明:
函数名 | 说明 |
onPageLoad | 页面加载时触发。一个页面只会调用一次,参数 query 为打开当前页面时的参数对象。 |
onPageShow | 页面显示/切入前台时触发。 |
onPageReady | 页面初次渲染完成时触发。一个页面只会调用一次,代表页面已经准备妥当,可以和视图层进行交互。 |
onPageHide | 页面隐藏/切入后台时触发。 例如 app.navigateTo 或底部 tab 切换到其他页面,小程序切入后台等。 |
onPageUnload | 页面卸载时触发。例如 app.redirectTo 或 app.navigateBack 到其他页面时。 |
页面生命周期的可视化配置
选中左侧大纲树的页面根节点,即可在右侧属性面板下方的事件面板中看到对应配置入口,如下所示:
按钮绑定页面加载 load 事件,选择打开弹窗动作。
编辑弹窗内容,保存。
页面加载或者刷新,触发打开弹窗事件。
页面生命周期的代码化配置
可在编辑器右下角打开 代码编辑器。
选择对应页面文件夹下的 lifecycle 文件,即可对该页面的生命周期进行管理。
应用生命周期
应用生命周期说明:
函数名 | 说明 |
onAppLaunch | 当应用初始化完成时触发(全局只触发一次),参数为包含 query(应用启动参数)的对象。 |
onAppShow | 应用启动或从后台进入前台显示(小程序)时触发,该事件与 App.onShow 的回调参数一致。 |
onAppHide | 监听小程序切后台事件。该事件与 App.onHide 的回调时机一致。 |
onAppError | 小程序发生脚本错误或 API 调用报错时触发。 |
onAppPageNotFound | 小程序要打开的页面不存在时触发。 |
onAppUnhandledRejection | 小程序有未处理的 Promise 拒绝时触发。 |
更多生命周期相关介绍
了解更多微搭运行时的生命周期相关说明,请参见 应用/页面/组件生命周期。
了解如何在生命周期中调用自定义 JS 方法,请参见 代码编辑器。