前言
端午節回家了,所以好多天沒有更新,只想說還是待在家里舒服呀,媽媽各種做好吃的,小侄子侄女各種粘着我在室外玩,導致我三天下來不僅胖了一圈,還黑了一圈,上班第一天有同事就說我曬黑了,哭~~~,為了防止自己的"懶癌"症復發,趕緊打開電腦敲敲字,廢話不多說,我們就回到今天的主題,今天給大家介紹下微信小程序框架主體文件中的配置文件(app.json),其實我們在上一篇《我的微信小程序第二篇》中已經對app.json做過簡單的描述,在此篇中,我們將對其進行詳細的介紹。
正文
app.json是小程序的全局配置文件,編寫時需嚴格遵循json的格式規范,app.json在程序加載時加載,負責全局配置,其配置項有:
-
pages:設置頁面路徑,必填
-
window:設置默認頁面的窗口表現
-
tabBar:設置tab的表現
-
networkTimeOut:設置網絡超時時間
-
debug:設置是否開啟debug模式,默認關閉false
app.json文件內容整體結構如下;
-
pages配置
pages負責注冊小程序頁面,必須填寫,值為一個包含頁面路徑的數組,用來指定小程序由哪些頁面構成,如下所示:
//頁面路徑設置
"pages":[
"pages/index/index",
"pages/logs/logs"
]
pages中不需要填寫文件后綴名,渲染頁面時框架會自動尋找路徑.json,.js,.wxml,.wxss四個文件進行整合,建議文件名和目錄名保持一致,便於管理,pages配置中第一項代表小程序的初始頁面,小程序增加或者修改,刪除頁面都需要對pages進行相應的調整。
2.window配置
Window負責小程序狀態欄,導航條,標題,窗口背景色等系統級樣式。屬性有:
-
navigationBarBackgroundColor:導航欄背景色,默認值為#fff
-
navigationBarTextStyle:導航欄標題顏色,僅支持black/white,默認值為black
-
navigationBarTitleText:導航欄標題文字內容
-
backgroundTextStyle:下拉背景字體,loading圖樣式,僅支持dark/light
-
backgroundColor:窗口背景色,默認值為#ffffff
-
enablePullDownRefresh:是否開啟下拉刷新,默認為false,開啟后,當用戶下拉時會觸發頁面onPullDownRefresh事件
3.TabBar配置
當程序頂部或者底部需要菜單欄時,我們可以通過tabbar設置,非必填,屬性如下:
-
color:tab上文字默認顏色,默認值為#000000
-
selectedColor:tab上文字選中時的顏色,默認值為#000000
-
backgroundColor:tab背景色
-
borderStyle:tabbar上邊框顏色,僅支持black\white,默認值為black
-
list:tab的列表,必填項,其值為一個數組,最少2個,最多5個,數組中每一個項是一個對象,代表一個tab的相關配置,配置如下:
-
pagepath:頁面路徑,必須在pages中先定義,必填項
-
text:tab上按鈕的文字
-
iconpath:tab上icon的相對路徑,icon大小限制在40kb
-
selectedIconPath:選中圖片的相對路徑,,icon大小限制在40kb
-
position:在頂部或者底部顯示,可選值為bottom/top,默認值為bottom
4.networkTimeout配置
小程序中各種請求API的超時時間只能通過networktimeout統一設置,不能在api中單獨設置,屬性如下:
-
request:設置wx.request的超時時間,單位毫秒
-
connectSocket:設置wx.connectSocket的超時時間,單位毫秒
-
uploadFile:設置wx.uploadFile的超時時間,單位毫秒
-
downloadFile:設置wx.downloadFile的超時時間,單位為毫秒
5.debug配置
-
此配置項控制是否開啟debug模式,默認是關閉的,當開啟debug模式時,在開發者工具面板,調試信息以info形式輸出,有page注冊,頁面路由,數據更新,事件觸發,可以幫助開發者快速定位一些問題。
相關推薦:《微信小程序開發入門及案例詳解》---李駿
歡迎關注我的個人微信公眾號