- App() 函數用來註冊一個小程序。接受一個 object 參數,其指定小程序的生命週期函數
- 屬性
屬性 | 類型 | 描述 | 觸發時機 |
---|---|---|---|
onLaunch | Function | 生命週期函數--監聽小程序初始化 | 當小程序初始化完成時,會觸發 onLaunch(全局只觸發一次) |
onShow | Function | 生命週期函數--監聽小程序顯示 | 當小程序啓動,或從後臺進入前臺顯示,會觸發 onShow |
onHide | Function | 生命週期函數--監聽小程序隱藏 | 當小程序從前臺進入後臺,會觸發 onHide |
onError | Function | 錯誤監聽函數 | 當小程序發生腳本錯誤,或者 api 調用失敗時,會觸發 onError 並帶上錯誤信息 |
其他 | Any |
|
開發者可以添加任意的函數或數據到 Object 參數中,用
this 可以訪問 |
-
前後臺定義
- 當用戶點擊左上角關閉,或者按了設備 Home 鍵離開微信,小程序並沒有直接銷燬,而是進入了後臺;
- 當再次進入微信或再次打開小程序,又會從後臺進入前臺。
- 需要注意的是:只有當小程序進入後臺一定時間,或者系統資源佔用過高,纔會被真正的銷燬
- onLaunch, onShow 參數
字段 | 類型 | 說明 |
---|---|---|
path | String | 打開小程序的路徑 |
query | Object | 打開小程序的query |
scene | Number | 打開小程序的場景值 |
shareTicket | String | shareTicket,詳見 獲取更多轉發信息 |
referrerInfo | Object | 當場景爲由從另一個小程序或公衆號或App打開時,返回此字段 |
referrerInfo.appId | String | 來源小程序或公衆號或App的 appId,詳見下方說明 |
referrerInfo.extraData | Object | 來源小程序傳過來的數據,scene=1037或1038時支持 |
- 全局的 getApp() 函數可以用來獲取到小程序實例。
-
注意
- App() 必須在 app.js 中註冊,且不能註冊多個
- 不要在定義於 App() 內的函數中調用 getApp() ,使用 this 就可以拿到 app 實例
- 不要在 onLaunch 的時候調用 getCurrentPages(),此時 page 還沒有生成
- 通過 getApp() 獲取實例之後,不要私自調用生命週期函數