全局配置~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
}
配置項(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模式 |
1.pages配置項(xiàng)
pages配置項(xiàng)接受一個(gè)數(shù)組苛秕,用來(lái)指定小程序由哪些頁(yè)面組成,是必需的配置項(xiàng)找默。數(shù)組的每一項(xiàng)都是字符串艇劫,代表對(duì)應(yīng)頁(yè)面的“路徑+文件名”信息。
pages配置項(xiàng)要注意三點(diǎn):
1)數(shù)組的第一項(xiàng)用于設(shè)定小程序的初始頁(yè)面惩激,即小程序啟動(dòng)頁(yè)店煞。
2)小程序中新增/減少頁(yè)面,都需要對(duì)pages數(shù)組進(jìn)行修改风钻。
3)文件名不需要寫文件后綴顷蟀。小程序框架會(huì)自動(dòng)去尋找路徑.json、.js骡技、.wxml鸣个、.wxss這四類文件進(jìn)行整合。
{
"pages":[
"pages/index/index" ,
"pages/logs/logs"
]
}
2.window配置項(xiàng)
window配置項(xiàng)接受對(duì)象值布朦,用來(lái)設(shè)置小程序的狀態(tài)欄囤萤、導(dǎo)航條、標(biāo)題是趴、窗口等對(duì)象的顏色涛舍、背景色、內(nèi)容屬性右遭,非必填配置項(xiàng)做盅。沒(méi)有配置時(shí)將使用默認(rèn)值。
{
"window":{
"navigationBarBackgroundColor": "#ffffff", "navigationBarTextStyle": "black",
"navigationBarTitleText": "微信接口功能演示",
"backgroundColor": "#eeeeee",
"backgroundTextStyle": "light" }
}
對(duì)象 | 類型 | 默認(rèn)值 | 描述 |
---|---|---|---|
navigationBarBackgroundColor | HexColor | #000000 | 導(dǎo)航欄背景顏色 |
navigationBarTextStyle | String | white | 導(dǎo)航欄標(biāo)題顏色 |
navigationBarTitleText | String | ... | 導(dǎo)航欄標(biāo)題文字內(nèi)容 |
backgroundColor | HexColor | #ffffff | 窗口的背景色 |
backgroundTextStyle | String | dark | 下拉背景字體窘哈、loading圖的樣式吹榴,僅支持dark/light |
enablePullDownRefresh | Boolean | false | 是否開(kāi)啟下拉刷新 |
3.tabBar配置項(xiàng)
小程序可以是多標(biāo)簽頁(yè)切換的應(yīng)用,這種情況下滚婉,就需要通過(guò)tabBar配置項(xiàng)來(lái)指定標(biāo)簽頁(yè)的表現(xiàn)图筹,及標(biāo)簽頁(yè)切換時(shí)所顯示的對(duì)應(yīng)頁(yè)面;
對(duì)象 | 類型 | 必填 | 默認(rèn)值 | 描述 |
---|---|---|---|---|
color | HexColor | 是 | ... | 標(biāo)簽上的文字默認(rèn)顏色 |
selectedColor | HexColor | 是 | ... | 標(biāo)簽頁(yè)上的文字選中時(shí)的顏色 |
backgroundColor | HexColor | 是 | ... | 標(biāo)簽頁(yè)的背景色 |
borderStyle | String | 否 | black | 標(biāo)簽條上的框線顏色,僅支持black/white |
list | Array | 是 | ... | 標(biāo)簽頁(yè)列表,支持最少2個(gè)远剩,最多5個(gè)標(biāo)簽頁(yè) |
position | String | 否 | bottom | 可選值bottom扣溺、top |
對(duì)象 | 類型 | 必填 | 描述 |
---|---|---|---|
pagePath | String | 是 | 頁(yè)面路徑,必須在pages中先定義 |
text | String | 是 | 標(biāo)簽頁(yè)上的按鈕文字 |
iconPath | String | 是 | 標(biāo)簽上icon圖片路徑瓜晤,icon圖片大小限制為40KB |
selectedIconPath | String | 是 | 選中標(biāo)簽時(shí)的icon圖片路徑锥余,icon圖片大小限制為40KB |
tabBar配置項(xiàng)接受多個(gè)對(duì)象的設(shè)定,其中的對(duì)象list(列表)是一個(gè)數(shù)組痢掠,用于配置標(biāo)簽頁(yè)驱犹。
注意:
1).只能配置最少2個(gè)、最多5個(gè)標(biāo)簽頁(yè)足画。標(biāo)簽頁(yè)按數(shù)組的順序排序雄驹。
2).list(列表)接受數(shù)組值,數(shù)組中的每一項(xiàng)也都是一個(gè)對(duì)象淹辞。
對(duì)象的數(shù)據(jù)值說(shuō)明如下:
對(duì)象 | 類型 | 必填 | 描述 |
---|---|---|---|
pagePath | String | 是 | 頁(yè)面路徑医舆,必須在pages中先定義 |
text | String | 是 | 標(biāo)簽頁(yè)上的按鈕文字 |
iconPath | String | 是 | 標(biāo)簽上icon圖片路徑,icon圖片大小限制為40KB |
selectedIconPath | String | 是 | 選中標(biāo)簽時(shí)的icon圖片路徑象缀,icon圖片大小限制為40KB |
代碼:
{ "tabBar":
{ "color":"#dddddd",
"selectedColor":"#3cc51f",
"borderStyle":"black",
"backgroundColor":"#ffffff",
"list": [{ "pagePath": "pages/components ",
"iconPath": "pages/images/components.png", "selectedIconPath": "pages/images/componentsHL.png",
"text": "組件" },
{ "pagePath": "pages/interface",
"iconPath": "pages/images/interface.png",
"selectedIconPath": "pages/images/interfaceHL.png",
"text": "接口" }]
}
}
4.networkTimeout配置項(xiàng)
networkTimeout配置項(xiàng)用于設(shè)置各種網(wǎng)絡(luò)請(qǐng)求對(duì)象的超時(shí)時(shí)間蔬将,非必須配置項(xiàng)⊙胄牵可設(shè)置的網(wǎng)絡(luò)請(qǐng)求超時(shí)的相關(guān)對(duì)象有request娃胆、connectSocket、uploadFile等曼、downloadFile里烦。超時(shí)的單位均為毫秒。這些超時(shí)若不設(shè)置禁谦,則默認(rèn)使用操作系統(tǒng)內(nèi)核或遵循服務(wù)器WebServer的設(shè)定值胁黑。
對(duì)象 | 類型 | 必填 | 描述 |
---|---|---|---|
request | Number | 否 | wx.request的超時(shí)時(shí)間,單位為ms |
connectSocket | Number | 否 | wx.connectSocket的超時(shí)時(shí)間州泊,單位為ms |
uploadFile | Number | 否 | wx.uploadFile的超時(shí)時(shí)間丧蘸,單位為ms |
downloadFile | Number | 否 | wx.downloadFile的超時(shí)時(shí)間,單位為ms |
代碼:
{
"networkTimeout": { "request":30000,
"connectSocket":30000,
"uploadFile":30000,
"downloadFile":30000 }
}
5.debug配置項(xiàng)
debug配置項(xiàng)用于開(kāi)啟開(kāi)發(fā)者工具的調(diào)試模式遥皂,它接受一個(gè)boolean值(默認(rèn)值是false)力喷。開(kāi)啟后,頁(yè)面(page)的注冊(cè)演训、頁(yè)面路由弟孟、數(shù)據(jù)更新、事件觸發(fā)等調(diào)試信息將以info的形式样悟,輸出在“調(diào)試”功能的console(控制臺(tái))面板上拂募。
比如庭猩,以下配置為打開(kāi)調(diào)試模式:
{ "debug": true }
頁(yè)面配置~page.json
頁(yè)面.json文件配置比app.json配置簡(jiǎn)單得多,只能設(shè)置window配置項(xiàng)的內(nèi)容陈症。顯然頁(yè)面.json文件中的window配置值將覆蓋app.json中的配置值蔼水。
{ "navigationBarBackgroundColor": "#ffffff",
"navigationBarTextStyle": "black",
"navigationBarTitleText": "微信接口功能演示",
"backgroundColor": "#eeeeee",
"backgroundTextStyle": "light" }