微信小程式――配置

以下就是小編對小程式配置的資料進(jìn)行的系統(tǒng)的整理，希望能對開發(fā)者有幫助。

我們使用app.json檔案來對微信小程式進(jìn)行全域配置，決定頁面檔案的路徑、視窗表現(xiàn)、設(shè)定網(wǎng)路逾時時間、設(shè)定多 tab 等。

以下是一個包含了所有配置選項(xiàng)的簡單配置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 配置項(xiàng)目清單

填類型

填類型

描述

pages ? ?Array ? ?是? ?設(shè)定頁路徑? ?

window ? ?Object ?????? ?

networkTimeout ? ?Object ? ?否? ?設(shè)定網(wǎng)路逾時時間? ?

debug ? ?Boolean ? ?

pages

接受一個數(shù)組，每一項(xiàng)都是字串，來指定小程式由哪些頁面組成。每一項(xiàng)代表對應(yīng)頁面的【路徑+檔名】訊息，數(shù)組的第一項(xiàng)代表小程式的初始頁面。小程式中新增/減少頁面，都需要對 pages 陣列進(jìn)行修改。

檔案名稱不需要寫檔案後綴，因?yàn)榭蚣軙詣尤ふ衣窂?json,.js,.wxml,.wxss的四個檔案進(jìn)行整合。

如開發(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

用於設(shè)定小程式的狀態(tài)列、導(dǎo)覽條、標(biāo)題、視窗背景色。

屬性

類型

屬性

類型

. #000000 ? ?導(dǎo)覽列背景顏色，如"#000000" ? ?

navigationBarTextStyle ? ?String ? ?white ? ?導(dǎo)覽列標(biāo)題顏色，只支援black/white ? ?

navigationBarTitleText ? ?String ? ?導(dǎo)覽列標(biāo)題文字內(nèi)容? ?

backgroundColor ? ??? ?dark ? ?下拉背景字型、loading 圖形的樣式，只支援dark/light ? ?

註：HexColor （十六進(jìn)位顏色值），如"#ff00ff"

如app.json ：

{  
 "window":{  
  "navigationBarBackgroundColor": "#ffffff",  
  "navigationBarTextStyle": "black",  
  "navigationBarTitleText": "微信接口功能演示",  
  "backgroundColor": "#eeeeee",  
  "backgroundTextStyle": "light"  
 }  
}

tabBar

如果我們的小程式是一個多tab 應(yīng)用程式（客戶端視窗的底部有tabtab切換頁面），那麼我們可以透過tabBar 配置項(xiàng)目來指定tab 欄的表現(xiàn)，以及tab 切換時顯示的對應(yīng)頁面。

tabBar 是一個數(shù)組，只能配置最少2個、最多5個 tab，tab 依數(shù)組的順序排序。

屬性說明：

屬性

?HexColor ? ?是? ?tab 上的文字預(yù)設(shè)顏色? ?

selectedColor ? ?HexColor是? ?tab 上的文字選取時的顏色? ?

backgroundColor ? ?HexColor ? ?是? ?tab 的背景色? ?

borderStyle ?tab 的背景色? ?

borderStyle ?? ?

list ? ?Array ? ?是? ?tab 的列表，詳見list 屬性說明，最少2個、最多5個tab ? ?

其中l(wèi)ist 接受一個數(shù)組，數(shù)組中的每個項(xiàng)目都是一個對象，其屬性值如下：

必填

說明

pagePath ? ?String ? ?是? ?頁路徑，必須在pages 中定義?String ? ?是? ?圖片路徑，icon 大小限制為40kb ? ?

selectedIconPath ? ?String ? ?是? ?選中時的圖片路徑，icon 大小限制為40kb

? ?

networkTimeout

可以設(shè)定各種網(wǎng)路請求的逾時時間。

屬性說明：

屬性

?否 ? ?wx.request的超時時間，單位毫秒 ? ?

connectSocket Number 否 wx.connectSocket的超時時間，單位毫秒

uploadFile Number 否 wx.uploadFile的超時時間，單位毫秒

downloadFile Number 否 wx.downloadFile的超時時間，單位毫秒

debug

可以在開發(fā)者工具中開啟 debug 模式，在開發(fā)者工具的控制臺面板，調(diào)試信息以 info 的形式給出，其信息有Page的注冊，頁面路由，數(shù)據(jù)更新，事件觸發(fā) 。 可以幫助開發(fā)者快速定位一些常見的問題。

page.json

每一個小程序頁面也可以使用.json文件來對本頁面的窗口表現(xiàn)進(jìn)行配置。 頁面的配置比app.json全局配置簡單得多，只是設(shè)置 app.json 中的 window 配置項(xiàng)的內(nèi)容，頁面中配置項(xiàng)會覆蓋 app.json 的 window 中相同的配置項(xiàng)。

頁面的.json只能設(shè)置 window 相關(guān)的配置項(xiàng)，以決定本頁面的窗口表現(xiàn)，所以無需寫 window 這個鍵，如：

{  
 "navigationBarBackgroundColor": "#ffffff",  
 "navigationBarTextStyle": "black",  
 "navigationBarTitleText": "微信接口功能演示",  
 "backgroundColor": "#eeeeee",  
 "backgroundTextStyle": "light"  
}

以上就是微信小程序 教程之小程序配置的內(nèi)容，更多相關(guān)內(nèi)容請關(guān)注PHP中文網(wǎng)（m.miracleart.cn）！