小程序配置
配置
我們使用app.json
文件來對微信小程序進行全局配置,決定頁面文件的路徑、窗口表現(xiàn)、設置網(wǎng)絡超時時間、設置多 tab 等。
以下是一個包含了所有配置選項的簡單配置app.json
:
{ "pages": [ "pages/index/index", "pages/logs/index" ], "window": { "navigationBarTitleText": "Demo" }, "tabBar": { "list": [{ "pagePath": "pages/index/index", "text": "首頁" }, { "pagePath": "pages/logs/logs", "text": "日志" }] }, "networkTimeout": { "request": 10000, "downloadFile": 10000 }, "debug": true }
app.json 配置項列表
pages
接受一個數(shù)組,每一項都是字符串,來指定小程序由哪些頁面組成。每一項代表對應頁面的【路徑+文件名】信息,數(shù)組的第一項代表小程序的初始頁面。小程序中新增/減少頁面,都需要對 pages 數(shù)組進行修改。
文件名不需要寫文件后綴,因為框架會自動去尋找路徑.json
,.js
,.wxml
,.wxss
的四個文件進行整合。
如開發(fā)目錄為:
pages/
pages/index/index.wxml
pages/index/index.js
pages/index/index.wxss
pages/logs/logs.wxml
pages/logs/logs.js
app.js
app.json
app.wxss
則,我們需要在 app.json 中寫
{ "pages":[ "pages/index/index" "pages/logs/logs" ] }
window
用于設置小程序的狀態(tài)欄、導航條、標題、窗口背景色。
注:HexColor(十六進制顏色值),如"#ff00ff"
如 app.json :
{ "window":{ "navigationBarBackgroundColor": "#ffffff", "navigationBarTextStyle": "black", "navigationBarTitleText": "微信接口功能演示", "backgroundColor": "#eeeeee", "backgroundTextStyle": "light" } }
tabBar
如果我們的小程序是一個多 tab 應用(客戶端窗口的底部有tab欄可以切換頁面),那么我們可以通過 tabBar 配置項指定 tab 欄的表現(xiàn),以及 tab 切換時顯示的對應頁面。
tabBar 是一個數(shù)組,只能配置最少2個、最多5個 tab,tab 按數(shù)組的順序排序。
屬性說明:
其中 list 接受一個數(shù)組,數(shù)組中的每個項都是一個對象,其屬性值如下:
networkTimeout
可以設置各種網(wǎng)絡請求的超時時間。
屬性說明:
debug
可以在開發(fā)者工具中開啟 debug 模式,在開發(fā)者工具的控制臺面板,調(diào)試信息以 info 的形式給出,其信息有Page的注冊
,頁面路由
,數(shù)據(jù)更新
,事件觸發(fā)
。 可以幫助開發(fā)者快速定位一些常見的問題。
page.json
每一個小程序頁面也可以使用.json
文件來對本頁面的窗口表現(xiàn)進行配置。 頁面的配置比app.json
全局配置簡單得多,只是設置 app.json 中的 window 配置項的內(nèi)容,頁面中配置項會覆蓋 app.json 的 window 中相同的配置項。
頁面的.json
只能設置 window
相關(guān)的配置項,以決定本頁面的窗口表現(xiàn),所以無需寫 window
這個鍵,如:
{ "window":{ "navigationBarBackgroundColor": "#ffffff", "navigationBarTextStyle": "black", "navigationBarTitleText": "微信接口功能演示", "backgroundColor": "#eeeeee", "backgroundTextStyle": "light" } }