微信小程序――配置
以下就是小編對(duì)小程序配置的資料進(jìn)行的系統(tǒng)的整理,希望能對(duì)開(kāi)發(fā)者有幫助。
我們使用app.json文件來(lái)對(duì)微信小程序進(jìn)行全局配置,決定頁(yè)面文件的路徑、窗口表現(xiàn)、設(shè)置網(wǎng)絡(luò)超時(shí)時(shí)間、設(shè)置多 tab 等。
以下是一個(gè)包含了所有配置選項(xiàng)的簡(jiǎn)單配置app.json :
{ "pages": [ "pages/index/index", "pages/logs/index" ], "window": { "navigationBarTitleText": "Demo" }, "tabBar": { "list": [{ "pagePath": "pages/index/index", "text": "首頁(yè)" }, { "pagePath": "pages/logs/logs", "text": "日志" }] }, "networkTimeout": { "request": 10000, "downloadFile": 10000 }, "debug": true}app.json 配置項(xiàng)列表
| 屬性 | 類型 | 必填 | 描述 |
|---|---|---|---|
| pages | Array | 是 | 設(shè)置頁(yè)面路徑 |
| window | Object | 否 | 設(shè)置默認(rèn)頁(yè)面的窗口表現(xiàn) |
| tabBar | Object | 否 | 設(shè)置底部 tab 的表現(xiàn) |
| networkTimeout | Object | 否 | 設(shè)置網(wǎng)絡(luò)超時(shí)時(shí)間 |
| debug | Boolean | 否 | 設(shè)置是否開(kāi)啟 debug 模式 |
pages
接受一個(gè)數(shù)組,每一項(xiàng)都是字符串,來(lái)指定小程序由哪些頁(yè)面組成。每一項(xiàng)代表對(duì)應(yīng)頁(yè)面的【路徑+文件名】信息,數(shù)組的第一項(xiàng)代表小程序的初始頁(yè)面。小程序中新增/減少頁(yè)面,都需要對(duì) pages 數(shù)組進(jìn)行修改。
文件名不需要寫文件后綴,因?yàn)榭蚣軙?huì)自動(dòng)去尋找路徑.json,.js,.wxml,.wxss的四個(gè)文件進(jìn)行整合。
如開(kāi)發(fā)目錄為:
pages/pages/index/index.wxmlpages/index/index.jspages/index/index.wxsspages/logs/logs.wxmlpages/logs/logs.jsapp.jsapp.jsonapp.wxss
則,我們需要在 app.json 中寫
{ "pages":[ "pages/index/index" "pages/logs/logs" ]}window
用于設(shè)置小程序的狀態(tài)欄、導(dǎo)航條、標(biāo)題、窗口背景色。
| 屬性 | 類型 | 默認(rèn)值 | 描述 |
|---|---|---|---|
| navigationBarBackgroundColor | HexColor | #000000 | 導(dǎo)航欄背景顏色,如"#000000" |
| navigationBarTextStyle | String | white | 導(dǎo)航欄標(biāo)題顏色,僅支持 black/white |
| navigationBarTitleText | String | 導(dǎo)航欄標(biāo)題文字內(nèi)容 | |
| backgroundColor | HexColor | #ffffff | 窗口的背景色 |
| backgroundTextStyle | String | dark | 下拉背景字體、loading 圖的樣式,僅支持 dark/light |
注:HexColor(十六進(jìn)制顏色值),如"#ff00ff"
如 app.json :
{ "window":{ "navigationBarBackgroundColor": "#ffffff", "navigationBarTextStyle": "black", "navigationBarTitleText": "微信接口功能演示", "backgroundColor": "#eeeeee", "backgroundTextStyle": "light" }} 
tabBar
如果我們的小程序是一個(gè)多 tab 應(yīng)用(客戶端窗口的底部有tab欄可以切換頁(yè)面),那么我們可以通過(guò) tabBar 配置項(xiàng)指定 tab 欄的表現(xiàn),以及 tab 切換時(shí)顯示的對(duì)應(yīng)頁(yè)面。
tabBar 是一個(gè)數(shù)組,只能配置最少2個(gè)、最多5個(gè) tab,tab 按數(shù)組的順序排序。
屬性說(shuō)明:
| 屬性 | 類型 | 必填 | 默認(rèn)值 | 描述 |
|---|---|---|---|---|
| color | HexColor | 是 | tab 上的文字默認(rèn)顏色 | |
| selectedColor | HexColor | 是 | tab 上的文字選中時(shí)的顏色 | |
| backgroundColor | HexColor | 是 | tab 的背景色 | |
| borderStyle | String | 否 | black | tabbar上邊框的顏色, 僅支持 black/white |
| list | Array | 是 | tab 的列表,詳見(jiàn) list 屬性說(shuō)明,最少2個(gè)、最多5個(gè) tab |
其中 list 接受一個(gè)數(shù)組,數(shù)組中的每個(gè)項(xiàng)都是一個(gè)對(duì)象,其屬性值如下:
| 屬性 | 類型 | 必填 | 說(shuō)明 |
|---|---|---|---|
| pagePath | String | 是 | 頁(yè)面路徑,必須在 pages 中先定義 |
| text | String | 是 | tab 上按鈕文字 |
| iconPath | String | 是 | 圖片路徑,icon 大小限制為40kb |
| selectedIconPath | String | 是 | 選中時(shí)的圖片路徑,icon 大小限制為40kb |

networkTimeout
可以設(shè)置各種網(wǎng)絡(luò)請(qǐng)求的超時(shí)時(shí)間。
屬性說(shuō)明:
| 屬性 | 類型 | 必填 | 說(shuō)明 |
|---|---|---|---|
| request | Number | 否 | wx.request的超時(shí)時(shí)間,單位毫秒 |
| connectSocket | Number | 否 | wx.connectSocket的超時(shí)時(shí)間,單位毫秒 |
| uploadFile | Number | 否 | wx.uploadFile的超時(shí)時(shí)間,單位毫秒 |
| downloadFile | Number | 否 | wx.downloadFile的超時(shí)時(shí)間,單位毫秒 |
debug
可以在開(kāi)發(fā)者工具中開(kāi)啟 debug 模式,在開(kāi)發(fā)者工具的控制臺(tái)面板,調(diào)試信息以 info 的形式給出,其信息有Page的注冊(cè),頁(yè)面路由,數(shù)據(jù)更新,事件觸發(fā) 。 可以幫助開(kāi)發(fā)者快速定位一些常見(jiàn)的問(wèn)題。
page.json
每一個(gè)小程序頁(yè)面也可以使用.json文件來(lái)對(duì)本頁(yè)面的窗口表現(xiàn)進(jìn)行配置。 頁(yè)面的配置比app.json全局配置簡(jiǎn)單得多,只是設(shè)置 app.json 中的 window 配置項(xiàng)的內(nèi)容,頁(yè)面中配置項(xiàng)會(huì)覆蓋 app.json 的 window 中相同的配置項(xiàng)。
頁(yè)面的.json只能設(shè)置 window 相關(guān)的配置項(xiàng),以決定本頁(yè)面的窗口表現(xiàn),所以無(wú)需寫 window 這個(gè)鍵,如:
{ "navigationBarBackgroundColor": "#ffffff", "navigationBarTextStyle": "black", "navigationBarTitleText": "微信接口功能演示", "backgroundColor": "#eeeeee", "backgroundTextStyle": "light"}感謝閱讀,希望能幫助到大家,謝謝大家對(duì)本站的支持!
新聞熱點(diǎn)
疑難解答
圖片精選
網(wǎng)友關(guān)注