目录
微信小程序生命周期可分为应用生命周期、页面生命周期和组件生命周期,本文结合微信官方文档浅析微信小程序的应用生命周期。从注册一个小程序生命周期开始讲起,到一些关于开发的小经验。废话少说,直接来。
1、App(Object object)
微信小程序应用生命周期从注册小程序生命周期开始说起,拿Vue.js这比喻,我们要使用Vue就得先new一个Vue对象。而微信小程序通过App(Object object)这个函数来注册小程序,接受一个 Object 参数,其指定小程序的生命周期回调等。
Tip: App() 必须在 app.js 中调用,必须调用且只能调用一次。不然会出现无法预期的后果。
2、App()参数
App(Object object)也可称为注册程序,这个程序里包含了些关于小程序生命周期相关的函数。或称为App()函数的参数,参数类型是Object object。如下
| 属性 | 类型 | 说明 | 触发时间 |
|---|---|---|---|
| onLaunch | function | 生命周期回调——监听小程序初始化。 | 小程序初始化完成时触发,全局只触发一次。 |
| onShow | function | 生命周期回调——监听小程序启动或切前台。 | 小程序启动,或从后台进入前台显示时触发。 |
| onHide | function | 生命周期回调——监听小程序切后台。 | 小程序从前台进入后台时触发。 |
| onError | function | 错误监听函数。 | 小程序发生脚本错误或 API 调用报错时触发。 |
| onPageNotFound | function | 页面不存在监听函数。 | 小程序要打开的页面不存在时触发。基础库 1.9.90 开始支持 |
| onUnhandledRejection | function | 未处理的 Promise 拒绝事件监听函数。 | 小程序有未处理的 Promise 拒绝时触发。基础库 2.10.0 开始支持。 |
| onThemeChange | function | 监听系统主题变化 | 系统切换主题时触发。基础库 2.11.0 开始支持。 |
| 其他 | any | 开发者可以添加任意的函数或数据变量到 Object 参数中,用 this 可以访问 |
3、示例代码
- App({
- onLaunch (options) {
- // Do something initial when launch.
- },
- onShow (options) {
- // Do something when show.
- },
- onHide () {
- // Do something when hide.
- },
- onError (msg) {
- console.log(msg)
- },
- globalData: 'I am global data'
- })
这里需要特别说明的是 globalData 这个函数/对象,这里可以写成函数也可以写成一个单独的变量,这个函数的作用通常是存储全局变量。例如我们在开发过程中可以将后端给的API链接前缀写在这里,这样在项目上线的时候更改API前缀我们就不用一个个去改。如下
app.js中
- //当要存储多个全局变量时,应该这样写
- globalData: {
- userInfo: null,
- urlFirst:'http://192.168.1.15:8089/AppleCampus/f'
- }
再需要使用的页面js文件下,例如index.js中,这样去使用
- //index.js
- //获取应用实例
- const app = getApp()
-
- Page({
- data: {
- //……
- },
- onLoad: function () {
- wx.request({
- //使用应用实例对象app去点访问app.js下的globalData函数下的urlFirst 变量
- url: app.globalData.urlFirst + '/module/index/getScheduleData',
- data: {},
- success(res) {
- }
- });
- })
这里最后描述的全局表量的使用其实就相当于一点自己的开发经验了。
生命周期(Life Cycle)是指一个对象从创建→>运行>销毁的整个阶段,强调的是一个时间段。如:
我们可以把每个小程序运行的过程,也概括为生命周期:
在小程序中,生命周期分为两类,分别是:
其中,页面的生命周期范围较小,应用程序的生命周期范围较大:
生命周期函数:是由小程序框架提供的内置函数,会伴随着生命周期,自动按次序执行。
生命周期函数的作用:允许程序员在特定的时间点,执行某些特定的操作。例如,页面刚加载的时候,可以在onLoad生命周期函数中初始化页面的数据。
注意:生命周期强调的是时间段,生命周期函数强调的是时间点。
小程序中的生命周期函数分为两类,分别是:
小程序的应用生命周期函数需要在app.js 中进行声明。如:
- App({
- /**
- * 当小程序初始化完成时,会触发 onLaunch(全局只触发一次)
- */
- onLaunch: function () {
- console.log("小程序启动!");
- },
- /**
- * 当小程序启动,或从后台进入前台显示,会触发 onShow
- */
- onShow: function (options) {
- console.log('小程序正在前台运行!');
- },
- /**
- * 当小程序从前台进入后台,会触发 onHide
- */
- onHide: function () {
- console.log("小程序进入后台运行!");
- },
- /**
- * 当小程序发生脚本错误,或者 api 调用失败时,会触发 onError 并带上错误信息
- */
- onError: function (msg) {
-
- }
- })
onLaunch(全局只触发一次)。onShow方法,监听小程序显示。onHide方法。onShow方法。| 属性 | 类型 | 描述 | 触发时机 |
|---|---|---|---|
| onLaunch | Function | 监听小程序初始化 | 当小程序初始化完成时,会触发 onLaunch(全局只触发一次)。 |
| onShow | Function | 监听小程序显示 | 当小程序启动,或从后台进入前台显示,会触发 onShow |
| onHide | Function | 监听小程序隐藏 | 当小程序从前台进入后台,会触发 onHide |
| onError | Function | 错误监听函数 | 当小程序发生脚本错误,或者 api 调用失败时,会触发 onError 并带上错误信息 |
| 其他 | Any | 开发者可以添加任意的函数或数据到 Object 参数中,用 this 可以访问,上面的getPics就是函数, globalName是数据,这里面的函数和数据都是全局的。调用方式:在Pager中通过getApp()方法得到App对象并获得全局的数据和调用全局的函数 |
前台、后台定义: 当用户点击左上角关闭,或者按了设备 Home 键离开微信小程序并没有直接销毁,而是进入了后台;当再次进入微信或再次打开小程序,又会从后台进入前台。
小程序的页面生命周期函数需要在页面.js 中进行声明。如:
- Page({
- /**
- * 页面的初始数据
- */
- data: {
- },
-
- /**
- * 生命周期函数--监听页面加载
- */
- onLoad(options) {
- console.log('本地生活页面加载完毕');
- },
- /**
- * 生命周期函数--监听页面初次渲染完成
- */
- onReady() {
- console.log("初次渲染完毕!");
- },
- /**
- * 生命周期函数--监听页面显示
- */
- onShow() {
- console.log("页面显示完成");
- },
- /**
- * 生命周期函数--监听页面隐藏
- */
- onHide() {
- console.log("页面已被隐藏!");
- },
- /**
- * 生命周期函数--监听页面卸载
- */
- onUnload() {
- console.log("GG");
- },
-
- /**
- * 页面相关事件处理函数--监听用户下拉动作
- */
- onPullDownRefresh() {
- console.log('正在刷新!');
- },
-
- /**
- * 页面上拉触底事件的处理函数
- */
- onReachBottom() {
- console.log('正在加载更多!');
- },
-
- /**
- * 用户点击右上角分享
- */
- onShareAppMessage() {
- console.log('用户正在分享!');
- }
- })
onLoad方法。onShow方法,显示页面。onReady方法,渲染页面元素和样式,一个页面只会调用一次。onHide方法。onShow方法。wx.redirectTo(OBJECT)或关闭当前页返回上一页wx.navigateBack(),触发onUnload。| 函数 | 说明 | 作用 |
|---|---|---|
| onLoad | 生命周期回调—监听页面加载 | 发送请求获取数据 |
| onShow | 生命周期回调—监听页面显示 | 请求数据 |
| onReady | 生命周期回调—监听页面初次渲染完成 | 获取页面元素(少用) |
| onHide | 生命周期回调—监听页面隐藏 | 终止任务,如定时器或者播放音乐 |
| onUnload | 生命周期回调—监听页面卸载 | 终止任务 |

实例演示:

监听事件: