小程序开发全局配置
文章目錄
- 1.entryPagePath
- 2.pages
- 3.window
- 4.tabBar
- 5.debug
全局配置:小程序根目錄下的 app.json 文件用來對微信小程序進行配置,文件內容為一個 JSON 對象
以下內容均在 app.json中編寫
1.entryPagePath
指定小程序的默認啟動路徑(首頁),常見情景是從微信聊天列表頁下拉啟動、小程序列表啟動等。如果不填,將默認為 pages 列表的第一項,不支持帶頁面路徑參數。就是點擊編譯時顯示的第一個頁面地址,樣式代碼:
{"entryPagePath": "pages/index/index" }2.pages
用于指定小程序由哪些頁面組成,每一項都對應一個頁面的 路徑(含文件名) 信息。文件名不需要寫文件后綴,框架會自動去尋找對應位置的 .json, .js, .wxml, .wxss 四個文件進行處理。補充一點,可以在一個文件下面再添加與前綴不同的文件或者修改文件名前綴,但是在編寫時需要具體到那個文件名地址,不然會報錯。
pages的內容為一個數組,樣式代碼:
3.window
用于設置小程序的狀態欄、導航條、標題、窗口背景色,以下舉一些常用的屬性
樣式代碼:
backgroundTextStyle是下拉 loading 的樣式,僅支持 dark 和light;
navigationBarBackgroundColor是導航欄背景顏色,默認6位的16進制數,例#000000;
backgroundColorBottom是底部窗口的背景色,僅 iOS 支持;
navigationBarTitleText是導航欄標題文字內容;
navigationBarTextStyle是導航欄標題顏色,僅支持 black 和 white;
backgroundColor是窗口的背景色,下拉刷新時空白處的顏色,可以為6位的16進制數;
enablePullDownRefresh是是否開啟全局的下拉刷新,僅有true和false兩個選項;
效果圖
4.tabBar
如果小程序是一個多工具欄的應用(客戶端窗口的底部或頂部有 tab 欄可以切換頁面),可以通過 tabBar 配置項指定 tab 欄的表現,以及 tab 切換時顯示的對應頁面,我們以三個工具欄為例,增加的話可以自行添加。但是要注意,工具欄最少兩個,最多五個。
樣式代碼:
color是tab上的文字默認顏色,僅支持十六進制顏色;
selectedColor是tab上的文字選中時的顏色,僅支持十六進制顏色;
backgroundColor是tab的背景色,僅支持十六進制顏色;
borderStyle是tabBar上邊框的顏色,僅支持black和white;
position是tabBar的位置,僅支持 bottom和top;
list是tab的列表,其中 list 接受一個數組,只能配置最少 2 個,最多 5 個 tab。tab 按數組的順序排序,每個項都是一個對象,其屬性值如下:
pagePath是頁面路徑,必須在 pages 中先定義;
text是tab上按鈕文字;
iconPath是圖片路徑,icon 大小限制為 40kb,建議尺寸為 81px * 81px,不支持網絡圖片。當position 為 top時,不顯示 icon;未點擊時顯示的圖片;
selectedIconPath是選中時的圖片路徑,icon 大小限制為 40kb,建議尺寸為 81px * 81px,不支持網絡圖片;點擊時顯示的圖片;
效果圖
5.debug
可以在開發者工具中開啟 debug 模式,在開發者工具的控制臺面板,調試信息以 info 的形式給出,其信息有 Page 的注冊,頁面路由,數據更新,事件觸發等,可以幫助開發者快速定位一些常見的問題,可以選擇true或者false
這樣就基本完成了小程序全局配置了
總結
- 上一篇: 微信小程序部分功能介绍和实现
- 下一篇: 小程序开发学习(1)---app.jso