小程序的生命周期分為 app.js 管理的生命周期舶斧、每個(gè)page的生命周期负芋。
app.js 管理的生命周期
App() 函數(shù)用來(lái)注冊(cè)一個(gè)小程序消别。接收一個(gè)object參數(shù)算柳,指定生命周期函數(shù)低淡。App() 只能在app.js里面注冊(cè)且只能注冊(cè)一個(gè)。
object 參數(shù)說(shuō)明:
屬性 | 描述 | 觸發(fā)機(jī)制 |
---|---|---|
onLaunch | 監(jiān)聽(tīng)小程序初始化 | 當(dāng)小程序初始化完成時(shí)瞬项,觸發(fā)一次蔗蹋。(全局只觸發(fā)一次) |
onShow | 監(jiān)聽(tīng)小程序顯示 | 初始化完成 或 后臺(tái)進(jìn)入前臺(tái)顯示,觸發(fā)onShow |
onHide | 監(jiān)聽(tīng)小程序隱藏 | 前臺(tái)進(jìn)入后臺(tái)會(huì)觸發(fā)onHide(點(diǎn)擊后退按鈕 或 Home鍵返回桌面) |
其他 | 可以添加任意的函數(shù)或者數(shù)據(jù)到object中 | 用 this 可以訪問(wèn) |
小程序quickStart囱淋,在app.js自動(dòng)生成的App函數(shù):
//app.js
App({
onLaunch: function () {
// 展示本地存儲(chǔ)能力
var logs = wx.getStorageSync('logs') || []
logs.unshift(Date.now())
wx.setStorageSync('logs', logs)
// 登錄
wx.login({
success: res => {
// 發(fā)送 res.code 到后臺(tái)換取 openId, sessionKey, unionId
}
})
// 獲取用戶信息
wx.getSetting({
success: res => {
if (res.authSetting['scope.userInfo']) {
// 已經(jīng)授權(quán)猪杭,可以直接調(diào)用 getUserInfo 獲取頭像昵稱,不會(huì)彈框
wx.getUserInfo({
success: res => {
// 可以將 res 發(fā)送給后臺(tái)解碼出 unionId
this.globalData.userInfo = res.userInfo
// 由于 getUserInfo 是網(wǎng)絡(luò)請(qǐng)求妥衣,可能會(huì)在 Page.onLoad 之后才返回
// 所以此處加入 callback 以防止這種情況
if (this.userInfoReadyCallback) {
this.userInfoReadyCallback(res)
}
}
})
}
}
})
},
globalData: {
userInfo: null
}
})
注意事項(xiàng):
- 必須在app.js中注冊(cè)皂吮,只能注冊(cè)一個(gè)
- 不要在定義于app()內(nèi)函數(shù)中調(diào)用 getApp(),使用 this 就可以拿到app實(shí)例
- 不要在onLaunch的時(shí)候調(diào)用 getCurrentPage税手,此時(shí)page還沒(méi)生效
- 通過(guò) getApp() 獲取實(shí)例后蜂筹,不要自己調(diào)用生命周期函數(shù)
頁(yè)面的生命周期
Page() 函數(shù)用來(lái)注冊(cè)一個(gè)頁(yè)面。接受一個(gè) object 參數(shù)芦倒,實(shí)現(xiàn)頁(yè)面的初始數(shù)據(jù)艺挪、生命周期函數(shù)、事件處理函數(shù)等兵扬。
// pages/test/test.js
Page({
/**
* 頁(yè)面的初始數(shù)據(jù)
*/
data: {
},
/**
* 生命周期函數(shù)--監(jiān)聽(tīng)頁(yè)面加載
*/
onLoad: function (options) {
},
/**
* 生命周期函數(shù)--監(jiān)聽(tīng)頁(yè)面初次渲染完成
*/
onReady: function () {
},
/**
* 生命周期函數(shù)--監(jiān)聽(tīng)頁(yè)面顯示
*/
onShow: function () {
},
/**
* 生命周期函數(shù)--監(jiān)聽(tīng)頁(yè)面隱藏
*/
onHide: function () {
},
/**
* 生命周期函數(shù)--監(jiān)聽(tīng)頁(yè)面卸載
*/
onUnload: function () {
},
/**
* 頁(yè)面相關(guān)事件處理函數(shù)--監(jiān)聽(tīng)用戶下拉動(dòng)作
*/
onPullDownRefresh: function () {
},
/**
* 頁(yè)面上拉觸底事件的處理函數(shù)
*/
onReachBottom: function () {
},
/**
* 用戶點(diǎn)擊右上角分享
*/
onShareAppMessage: function () {
}
})
生命周期函數(shù):
- 對(duì)頁(yè)面的設(shè)置(如wx.setNavigationBarTitle)在 onReady 之后設(shè)置麻裳。
- onLoad函數(shù)中口蝠,參數(shù)可以獲取 wx.navigationTo 和 wx.redirectTo 及 <navigator/> 中的 query 。
函數(shù) | 說(shuō)明 |
---|---|
onLoad | 頁(yè)面加載津坑,一個(gè)頁(yè)面加載一次 |
onShow | 頁(yè)面顯示妙蔗,每次打開(kāi)頁(yè)面時(shí)調(diào)用 |
onReady | 頁(yè)面初次渲染完成,一個(gè)頁(yè)面只會(huì)調(diào)用一次疆瑰,代表頁(yè)面已經(jīng)準(zhǔn)備妥當(dāng)灭必,可以和視圖層進(jìn)行交互。 |
onHide | 頁(yè)面隱藏乃摹,當(dāng)navigationTo或底部tab切換時(shí)調(diào)用。 |
onUnload | 頁(yè)面卸載跟衅,當(dāng)redirectTo和navigateBack時(shí)調(diào)用孵睬。 |
頁(yè)面相關(guān)事件處理函數(shù)
onPullDownRefresh: 需要在window選項(xiàng)中添加 enablePullDownRefresh。當(dāng)處理完數(shù)據(jù)刷新后伶跷,wx.stopPullDownRefresh 可以停止當(dāng)前頁(yè)面的下拉刷新掰读。
onReachBottom: 上拉刷新事件。頁(yè)面上拉觸及底部的事件處理叭莫。
onShareAppMessage: 用戶點(diǎn)擊右上角轉(zhuǎn)發(fā)事件蹈集。只有定義了這個(gè)事件左上角才會(huì)有轉(zhuǎn)發(fā)Button,事件需要return一個(gè) object 雇初,用于自定義轉(zhuǎn)發(fā)內(nèi)容拢肆。自定義轉(zhuǎn)發(fā) title 和 path ,path 必須是以 / 開(kāi)頭的完整路徑靖诗。
onPageScroll: 頁(yè)面滾動(dòng)觸發(fā)事件的處理函數(shù)郭怪,參數(shù)是scrollTo(Number類型),表示頁(yè)面在垂直方向已滾動(dòng)距離(單位:px)刊橘。
使用代碼如下:
Page(
{
onPullDownRefresh: function () {
console.log("onPullDownRefresh" + new Date())
},
stopPullDownRefresh: function () {
wx.stopPullDownReferesh({
complete: function (res) {
console.log(res + new Date() )
}
})
},
onShareAppMessage: function () {
return
{
title: '自定義轉(zhuǎn)發(fā)標(biāo)題',
path: '/page/user?id=123'
}
},
}
)
事件處理函數(shù)
在渲染層可以在組件中加入事件綁定鄙才,當(dāng)達(dá)到觸發(fā)事件時(shí),就會(huì)執(zhí)行 Page 中定義的事件處理函數(shù)促绵。
- Page.prototype.route: 獲取當(dāng)前頁(yè)面路徑攒庵。
- Page.prototype.setData: 改變 this.data 的值,單次設(shè)置的數(shù)據(jù)不超過(guò)1024k败晴,盡量避免一次設(shè)置過(guò)多的數(shù)據(jù)浓冒。
-
文件作用域和模塊化:
- js頁(yè)面文件中聲明的變量和函數(shù)值在該文件中有效,不同的文件中可以聲明相同名字的變量和函數(shù)尖坤,不會(huì)相互影響裆蒸。
- 全局?jǐn)?shù)據(jù)可以在App()中設(shè)置。
- 提供函數(shù)給其他頁(yè)面使用糖驴,小程序 js 模塊只有通過(guò) moudle.exports 暴露接口僚祷,其他 js 頁(yè)面才可以引入引用佛致。
在 util.js 里面有exports的應(yīng)用