以下內(nèi)容全部引用微信小程序官方文檔媒熊,因官方文檔內(nèi)容較多奇适,查找比較繁瑣,常用的記錄留存芦鳍。
微信小程序官方文檔:組件生命周期
組件生命周期
組件的生命周期嚷往,指的是組件自身的一些函數(shù),這些函數(shù)在特殊的時(shí)間點(diǎn)或遇到一些特殊的框架事件時(shí)被自動觸發(fā)柠衅。
其中皮仁,最重要的生命周期是 created
attached
detached
,包含一個組件實(shí)例生命流程的最主要時(shí)間點(diǎn)菲宴。
- 組件實(shí)例剛剛被創(chuàng)建好時(shí)贷祈,
created
生命周期被觸發(fā)。此時(shí)裙顽,組件數(shù)據(jù)this.data
就是在Component
構(gòu)造器中定義的數(shù)據(jù)data
付燥。 此時(shí)還不能調(diào)用setData
。 通常情況下愈犹,這個生命周期只應(yīng)該用于給組件this
添加一些自定義屬性字段键科。 - 在組件完全初始化完畢闻丑、進(jìn)入頁面節(jié)點(diǎn)樹后,
attached
生命周期被觸發(fā)勋颖。此時(shí)嗦嗡,this.data
已被初始化為組件的當(dāng)前值。這個生命周期很有用饭玲,絕大多數(shù)初始化工作可以在這個時(shí)機(jī)進(jìn)行侥祭。 - 在組件離開頁面節(jié)點(diǎn)樹后,
detached
生命周期被觸發(fā)茄厘。退出一個頁面時(shí)矮冬,如果組件還在頁面節(jié)點(diǎn)樹中,則detached
會被觸發(fā)次哈。
定義生命周期方法
生命周期方法可以直接定義在 Component
構(gòu)造器的第一級參數(shù)中胎署。
自小程序基礎(chǔ)庫版本 2.2.3 起,組件的的生命周期也可以在 lifetimes
字段內(nèi)進(jìn)行聲明(這是推薦的方式窑滞,其優(yōu)先級最高)琼牧。
代碼示例:
Component({
lifetimes: {
attached: function() {
// 在組件實(shí)例進(jìn)入頁面節(jié)點(diǎn)樹時(shí)執(zhí)行
},
detached: function() {
// 在組件實(shí)例被從頁面節(jié)點(diǎn)樹移除時(shí)執(zhí)行
},
},
// 以下是舊式的定義方式,可以保持對 <2.2.3 版本基礎(chǔ)庫的兼容
attached: function() {
// 在組件實(shí)例進(jìn)入頁面節(jié)點(diǎn)樹時(shí)執(zhí)行
},
detached: function() {
// 在組件實(shí)例被從頁面節(jié)點(diǎn)樹移除時(shí)執(zhí)行
},
// ...
})
在 behaviors 中也可以編寫生命周期方法哀卫,同時(shí)不會與其他 behaviors 中的同名生命周期相互覆蓋巨坊。但要注意,如果一個組件多次直接或間接引用同一個 behavior 此改,這個 behavior 中的生命周期函數(shù)在一個執(zhí)行時(shí)機(jī)內(nèi)只會執(zhí)行一次趾撵。
可用的全部生命周期如下表所示。
生命周期 | 參數(shù) | 描述 | 最低版本 |
---|---|---|---|
created | 無 | 在組件實(shí)例剛剛被創(chuàng)建時(shí)執(zhí)行 | 1.6.3 |
attached | 無 | 在組件實(shí)例進(jìn)入頁面節(jié)點(diǎn)樹時(shí)執(zhí)行 | 1.6.3 |
ready | 無 | 在組件在視圖層布局完成后執(zhí)行 | 1.6.3 |
moved | 無 | 在組件實(shí)例被移動到節(jié)點(diǎn)樹另一個位置時(shí)執(zhí)行 | 1.6.3 |
detached | 無 | 在組件實(shí)例被從頁面節(jié)點(diǎn)樹移除時(shí)執(zhí)行 | 1.6.3 |
error | Object Error |
每當(dāng)組件方法拋出錯誤時(shí)執(zhí)行 | 2.4.1 |
組件所在頁面的生命周期
還有一些特殊的生命周期带斑,它們并非與組件有很強(qiáng)的關(guān)聯(lián)鼓寺,但有時(shí)組件需要獲知,以便組件內(nèi)部處理勋磕。這樣的生命周期稱為“組件所在頁面的生命周期”妈候,在 pageLifetimes
定義段中定義。其中可用的生命周期包括:
生命周期 | 參數(shù) | 描述 | 最低版本 |
---|---|---|---|
show | 無 | 組件所在的頁面被展示時(shí)執(zhí)行 | 2.2.3 |
hide | 無 | 組件所在的頁面被隱藏時(shí)執(zhí)行 | 2.2.3 |
resize | Object Size |
組件所在的頁面尺寸變化時(shí)執(zhí)行 | 2.4.0 |
代碼示例:
Component({
pageLifetimes: {
show: function() {
// 頁面被展示
},
hide: function() {
// 頁面被隱藏
},
resize: function(size) {
// 頁面尺寸變化
}
}
})