title: 生命周期函数 header: develop nav: framework

sidebar: app_service_pagelife

onLoad(Object query)

页面加载时触发。一个页面只会调用一次，可以在 onLoad 的参数中获取打开当前页面路径中的参数。

参数：

属性名 类型 说明
query Object 打开当前页面路径中的参数

代码示例

  1. // 添加onLoad代理示例
  3. var originPage = Page
  5. function MyPage(config) {
  6.    this.lifetimeProxy = {
  7.      onLoad: config.onLoad
  8.    }
  9.    config.onLoad = function(options) {
  10.      // 自定义代码
  11.      // 公共的初始化代码
  12.      this.userData = getUserData()
  13.    }
  15.   // ...
  17.   originPage(config)
  18. }

onShow()

页面显示/切入前台时触发。

onReady()

页面初次渲染完成时触发。一个页面只会调用一次，代表页面已经准备妥当，可以和视图层进行交互。

onHide()

页面隐藏/切入后台时触发。 如通过调用 swan.navigateTo 或底部 tab 切换到其他页面，小程序切入后台等时触发。

onUnload()

页面卸载时触发。如通过调用 swan.redirectTo 或 swan.navigateBack 到其他页面时触发。

注意

  • 在解析 query 的时候，基础库会使用decodeURIComponent对query的参数值进行一次解码，该功能将在新的版本中下线。
  • 如页面跳转时传递了 encode 后的值作为参数，为避免发生页面错误，使用时请自行将拿到的值使用decodeURIComponent进行一次decode操作。

更多内容参见生命周期。