微信小程式開發-app.json解析
App.json檔案解析
Page屬性:
接受一個數組,每一項都是字串,來指定小程式由哪些頁面組成。每一項代表對應頁面的【路徑+檔名】資訊,陣列的第一項代表小程式的初始頁面。小程式中新增/減少頁面,都需要對 pages 陣列進行修改。
檔名不需要寫檔案字尾,因為框架會自動去尋找路徑.json,.js,.wxml,.wxss的四個檔案進行整合
Window屬性:
屬性 |
型別 |
預設值 |
描述 |
navigationBarBackgroundColor |
HexColor |
#000000 |
導航欄背景顏色,如"#000000" |
navigationBarTextStyle |
String |
white |
導航欄標題顏色,僅支援 black/white |
navigationBarTitleText |
String |
|
導航欄標題文字內容 |
backgroundColor |
HexColor |
#ffffff |
視窗的背景色 |
backgroundTextStyle |
String |
dark |
下拉背景字型、 |
enablePullDownRefresh |
Boolean |
false |
是否開啟下拉重新整理,詳見頁面相關事件處理函式。 |
onReachBottomDistance |
Number |
50 |
頁面上拉觸底事件觸發時距頁面底部距離,單位為px |
tabBar屬性
如果我們的小程式是一個多 tab 應用(客戶端視窗的底部有tab欄可以切換頁面),那麼我們可以通過 tabBar 配置項指定 tab 欄的表現,以及 tab 切換時顯示的對應頁面。
Tip:
1. 當設定 position 為 top 時,將不會顯示 icon
2. tabBar 是一個數組,只能配置最少2個、最多5個 tab,tab 按陣列的順序排序。
屬性說明:
屬性 |
型別 |
必填 |
預設值 |
描述 |
color |
HexColor |
是 |
tab 上的文字預設顏色 |
|
selectedColor |
HexColor |
是 |
tab 上的文字選中時的顏色 |
|
backgroundColor |
HexColor |
是 |
tab 的背景色 |
|
borderStyle |
String |
否 |
black |
tabbar上邊框的顏色, 僅支援 black/white |
list |
Array |
是 |
tab 的列表,詳見 list 屬性說明,最少2個、最多5個 tab |
|
position |
String |
否 |
bottom |
可選值 bottom、top |
其中 list 接受一個數組,陣列中的每個項都是一個物件,其屬性值如下:
屬性 |
型別 |
必填 |
說明 |
pagePath |
String |
是 |
頁面路徑,必須在 pages 中先定義 |
text |
String |
是 |
tab 上按鈕文字 |
iconPath |
String |
否 |
圖片路徑,icon 大小限制為40kb,建議尺寸為 81px * 81px,當 postion 為 top 時,此引數無效 |
selectedIconPath |
String |
否 |
選中時的圖片路徑,icon 大小限制為40kb,建議尺寸為 81px * 81px ,當 postion 為 top 時,此引數無效 |
networkTimeout屬性
可以設定各種網路請求的超時時間。
屬性 |
型別 |
必填 |
說明 |
request |
Number |
否 |
wx.request的超時時間,單位毫秒 |
connectSocket |
Number |
否 |
wx.connectSocket的超時時間,單位毫秒 |
uploadFile |
Number |
否 |
wx.uploadFile的超時時間,單位毫秒 |
downloadFile |
Number |
否 |
wx.downloadFile的超時時間,單位毫秒 |
Debug屬性
可以在開發者工具中開啟 debug 模式,在開發者工具的控制檯面板,除錯資訊以 info 的形式給出,其資訊有Page的註冊,頁面路由,資料更新,事件觸發 。可以幫助開發者快速定位一些常見的問題