有奖捉虫:办公协同&微信生态&物联网文档专题 HOT
微搭支持页面、应用级别的生命周期函数,当对应的生命周期函数触发时,便会自动执行函数下已配置的事件动作或自定义方法。

页面生命周期

页面生命周期说明:
函数名
说明
onPageLoad
页面加载时触发。一个页面只会调用一次,参数 query 为打开当前页面时的参数对象。
onPageShow
页面显示/切入前台时触发。
onPageReady
页面初次渲染完成时触发。一个页面只会调用一次,代表页面已经准备妥当,可以和视图层进行交互。
onPageHide
页面隐藏/切入后台时触发。 例如 app.navigateTo 或底部 tab 切换到其他页面,小程序切入后台等。
onPageUnload
页面卸载时触发。例如 app.redirectToapp.navigateBack 到其他页面时。
页面生命周期支持可视化配置来调用事件动作或自定义方法,也可以支持在代码编辑器的页面生命周期函数中来执行相应的自定义代码,两种配置方式分别如下:

页面生命周期的可视化配置

选中左侧大纲树的页面根节点,即可在右侧属性面板下方的事件面板中看到对应配置入口,如下所示:
按钮绑定页面加载 load 事件,选择打开弹窗动作。



编辑弹窗内容,保存。



触发成功,出现弹窗。




页面生命周期的代码化配置

可在编辑器右下角打开 代码编辑器



选择对应页面文件夹下的 lifecycle 文件,即可对该页面的生命周期进行管理。




应用生命周期

打开 代码编辑器,选择全局文件夹下的 lifecycle 文件,即可对应用的生命周期进行管理和代码编写。



应用生命周期说明:
函数名
说明
onAppLaunch
当应用初始化完成时触发(全局只触发一次),参数为包含 query(应用启动参数)的对象。
onAppShow
应用启动或从后台进入前台显示(小程序)时触发,该事件与 App.onShow 的回调参数一致。
onAppHide
监听小程序切后台事件。该事件与 App.onHide 的回调时机一致。
onAppError
小程序发生脚本错误或 API 调用报错时触发。
onAppPageNotFound
小程序要打开的页面不存在时触发。
onAppUnhandledRejection
小程序有未处理的 Promise 拒绝时触发。

更多生命周期相关介绍

了解更多微搭运行时的生命周期相关说明,请参见 应用/页面/组件生命周期
了解如何在生命周期中调用自定义 JS 方法,请参见 代码编辑器