今天開始深度學(xué)習(xí)編程語法,雖然大部分是拷貝官方文檔,代碼類都是我自己敲的,希望能自己敲一遍表格里的內(nèi)容,熟悉一下操作文件目錄結(jié)構(gòu)之前大概提高到,沒有細說 先打開 app.js 文件
小程序 App打開 app.js 文件,會看到 App({…}) 函數(shù) App() 函數(shù)用來注冊一個小程序。接受一個 Object 參數(shù),其指定小程序的生命周期回調(diào)等 【注意】:App() 必須在 app.js 中調(diào)用,必須調(diào)用且只能調(diào)用一次。不然會出現(xiàn)無法預(yù)期的后果 Object參數(shù)說明:
屬性 | 類型 | 描述 | 觸發(fā)時機 |
---|
onLaunch | Function | 生命周期回調(diào)一監(jiān)聽小程序初始化 | 小程序初始化完成時(全局只觸發(fā)一次) | onShow | Function | 生命周期回調(diào)一監(jiān)聽小程序顯示 | 小程序啟動,或從后臺進入前臺顯示時 | onHide | Function | 生命周期回調(diào)一監(jiān)聽小程序隱藏 | 小程序從前臺進入后臺時 | onError | Function | 錯誤監(jiān)聽函數(shù) | 小程序發(fā)生腳本錯誤,或者 api 調(diào)用失敗時觸發(fā) ,會帶上錯誤信息 | onPageNotFound | Function | 頁面不存在監(jiān)聽函數(shù) | 小程序要打開的頁面不存在時觸發(fā),會帶上頁面信息回調(diào)該函數(shù) | 其他 | Any | 開發(fā)者可以添加任意的函數(shù)或數(shù)據(jù)到 Object 參數(shù)中,用 this 可以訪問 |
|
前臺、后臺定義:當(dāng)用戶點擊左上角關(guān)閉,或者按了設(shè)備 Home 鍵離開微信(也就是返回手機桌面,沒有退出微信),小程序并沒有直接銷毀,而是進入了后臺;當(dāng)再次進入微信或再次打開小程序,又會從后臺進入前臺。需要注意的是:只有當(dāng)小程序進入后臺一定時間,或者系統(tǒng)占用資源過高,才會真正被銷毀 關(guān)閉小程序(基礎(chǔ)庫版本1.1.0開始支持):當(dāng)用戶從掃一掃 ,轉(zhuǎn)發(fā)等入口(場景值(下面有介紹)為1007,1008,1011,1025)進入小程序,且沒有置頂小程序的情況下推出,小程序會被銷毀 小程序運行機制在基礎(chǔ)庫版本 1.4.0 有所改變:上一條關(guān)閉邏輯在新版已不適用 示例代碼:
//提示:當(dāng)在js文件中輸入app會提示函數(shù),直接回車會直接生產(chǎn)4個框架,快捷App({ /** * 當(dāng)小程序初始化完成時,會觸發(fā) onLaunch(全局只觸發(fā)一次) */ onLaunch: function () { }, /** * 當(dāng)小程序啟動,或從后臺進入前臺顯示,會觸發(fā) onShow */ onShow: function (options) { }, /** * 當(dāng)小程序從前臺進入后臺,會觸發(fā) onHide */ onHide: function () { }, /** * 當(dāng)小程序發(fā)生腳本錯誤,或者 api 調(diào)用失敗時,會觸發(fā) onError 并帶上錯誤信息 */ onError: function (msg) { } /** * 下面是自定義內(nèi)容 */ globalData: 'I am global data'}) 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35
詳細介紹.js 文件中App({…})函數(shù)各參數(shù)js 文件中App({…})函數(shù)參數(shù) - onLaunch(Object)字段 | 類型 | 說明 |
---|
path | String | 打開小程序的路徑 | query | Object | 打開小程序的query | scene | Number | 打開小程序的 場景值(下面有介紹) | shareTicket | String | shareTicket,詳見 獲取更多轉(zhuǎn)發(fā)信息(下面有介紹) | referrerInfo | Object | 當(dāng)場景為由從另一個小程序或公眾號或App打開時,返回此字段 | referrerInfo.appId | String | 來源小程序或公眾號或App的 appId,詳見下方說明 | referrerInfo.extraData | Object | 來源小程序傳過來的數(shù)據(jù),scene=1037或1038時支持 |
場景值 | 場景 | appId 信息含義 |
---|
1020 | 公眾號 profile 頁相關(guān)小程序列表 | 來源公眾號 appId | 1035 | 公眾號自定義菜單 | 來源公眾號 appId | 1036 | App 分享消息卡片 | 來源應(yīng)用 appId | 1037 | 小程序打開小程序 | 來源小程序 appId | 1038 | 從另一個小程序返回 | 來源小程序 appId | 1043 | 公眾號模板消息 | 來源公眾號 appId |
js 文件中App({…})函數(shù)參數(shù) - onShow(Object)小程序啟動,或從后臺進入前臺顯示時觸發(fā) Object 參數(shù)說明: 與上面 onLaunch 相同
js 文件中App({…})函數(shù)參數(shù) - onHide()js 文件中App({…})函數(shù)參數(shù) - onError(String error)名稱 | 類型 | 說明 |
---|
error | String | 錯誤信息,包含堆棧 |
js 文件中App({…})函數(shù)參數(shù) - onPageNotFound(Object)字段 | 類型 | 說明 |
---|
path | String | 不存在的頁面路徑 | query | Object | 打開不存在的頁面的 query | isEntryPage | Boolean | 是否本次啟動的首個頁面(例如從分享等入口進來,首個頁面是開發(fā)者配置的分享頁面) |
App({ onPageNotFound(res) { wx.redirectTo({ url: 'pages/...' }) // 如果是 tabbar 頁面,請使用 wx.switchTab }})
注意:
如果 onPageNotFound 回調(diào)中又重定向到另一個不存在的頁面,將推入微信客戶端原生的頁面不存在提示頁面,并且不再回調(diào) onPageNotFound
getApp(Object)字段 | 類型 | 說明 | 最低版本 |
---|
allowDefault | Boolean | 在 App 未定義時返回默認實現(xiàn)。當(dāng)App被調(diào)用時,默認實現(xiàn)中定義的屬性會被覆蓋合并到App中。一般用于[獨立分包](https://developers.weixin.qq.com/miniprogram/dev/framework/subpackages/independent.html) | 2.2.4 |
// 自定義的.jsvar appInstance = getApp()console.log(appInstance.globalData) // I am global data 場景值場景值ID | 說明 |
---|
1001 | 發(fā)現(xiàn)欄小程序主入口,“最近使用”列表(基礎(chǔ)庫2.2.4版本起將包含“我的小程序”列表) | 1005 | 頂部搜索框的搜索結(jié)果頁 | 1006 | 發(fā)現(xiàn)欄小程序主入口搜索框的搜索結(jié)果頁 | 1007 | 單人聊天會話中的小程序消息卡片 | 1008 | 群聊會話中的小程序消息卡片 | 1011 | 掃描二維碼 | 1012 | 長按圖片識別二維碼 | 1013 | 手機相冊選取二維碼 | 1014 | 小程序模版消息 | 1017 | 前往體驗版的入口頁 | 1019 | 微信錢包 | 1020 | 公眾號 profile 頁相關(guān)小程序列表 | 1022 | 聊天頂部置頂小程序入口 | 1023 | 安卓系統(tǒng)桌面圖標(biāo) | 1024 | 小程序 profile 頁 | 1025 | 掃描一維碼 | 1026 | 附近小程序列表 | 1027 | 頂部搜索框搜索結(jié)果頁“使用過的小程序”列表 | 1028 | 我的卡包 | 1029 | 卡券詳情頁 | 1030 | 自動化測試下打開小程序 | 1031 | 長按圖片識別一維碼 | 1032 | 手機相冊選取一維碼 | 1034 | 微信支付完成頁 | 1035 | 公眾號自定義菜單 | 1036 | App 分享消息卡片 | 1037 | 小程序打開小程序 | 1038 | 從另一個小程序返回 | 1039 | 搖電視 | 1042 | 添加好友搜索框的搜索結(jié)果頁 | 1043 | 公眾號模板消息 | 1044 | 帶 shareTicket 的小程序消息卡片 詳情 | 1045 | 朋友圈廣告 | 1046 | 朋友圈廣告詳情頁 | 1047 | 掃描小程序碼 | 1048 | 長按圖片識別小程序碼 | 1049 | 手機相冊選取小程序碼 | 1052 | 卡券的適用門店列表 | 1053 | 搜一搜的結(jié)果頁 | 1054 | 頂部搜索框小程序快捷入口 | 1056 | 音樂播放器菜單 | 1057 | 錢包中的銀行卡詳情頁 | 1058 | 公眾號文章 | 1059 | 體驗版小程序綁定邀請頁 | 1064 | 微信連Wi-Fi狀態(tài)欄 | 1067 | 公眾號文章廣告 | 1068 | 附近小程序列表廣告 | 1069 | 移動應(yīng)用 | 1071 | 錢包中的銀行卡列表頁 | 1072 | 二維碼收款頁面 | 1073 | 客服消息列表下發(fā)的小程序消息卡片 | 1074 | 公眾號會話下發(fā)的小程序消息卡片 | 1077 | 搖周邊 | 1078 | 連Wi-Fi成功頁 | 1079 | 微信游戲中心 | 1081 | 客服消息下發(fā)的文字鏈 | 1082 | 公眾號會話下發(fā)的文字鏈 | 1084 | 朋友圈廣告原生頁 | 1089 | 微信聊天主界面下拉,“最近使用”欄(基礎(chǔ)庫2.2.4版本起將包含“我的小程序”欄) | 1090 | 長按小程序右上角菜單喚出最近使用歷史 | 1091 | 公眾號文章商品卡片 | 1092 | 城市服務(wù)入口 | 1095 | 小程序廣告組件 | 1096 | 聊天記錄 | 1097 | 微信支付簽約頁 | 1099 | 頁面內(nèi)嵌插件 | 1102 | 公眾號 profile 頁服務(wù)預(yù)覽 | 1103 | 發(fā)現(xiàn)欄小程序主入口,“我的小程序”列表(基礎(chǔ)庫2.2.4版本起該場景值廢棄) | 1104 | 微信聊天主界面下拉,“我的小程序”欄(基礎(chǔ)庫2.2.4版本起該場景值廢棄) |
|