快捷導(dǎo)航

微信小程序教程之小程序配置

更新時(shí)間：2016年10月17日 16:00:22 投稿：lqh

這篇文章主要介紹了微信小程序教程之小程序配置的相關(guān)資料,這里對(duì)app.json,pages,window等做了詳細(xì)介紹，對(duì)于初學(xué)開發(fā)微信小程序的朋友，掌握這些還是比較重要的，需要的朋友可以參考下

微信小程序——配置

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

我們使用app.json文件來對(duì)微信小程序進(jìn)行全局配置，決定頁面文件的路徑、窗口表現(xiàn)、設(shè)置網(wǎng)絡(luò)超時(shí)時(shí)間、設(shè)置多 tab 等。

以下是一個(gè)包含了所有配置選項(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	否	設(shè)置默認(rèn)頁面的窗口表現(xiàn)
tabBar	Object	否	設(shè)置底部 tab 的表現(xiàn)
networkTimeout	Object	否	設(shè)置網(wǎng)絡(luò)超時(shí)時(shí)間
debug	Boolean	否	設(shè)置是否開啟 debug 模式

pages

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

文件名不需要寫文件后綴，因?yàn)榭蚣軙?huì)自動(dòng)去尋找路徑.json,.js,.wxml,.wxss的四個(gè)文件進(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)題、窗口背景色。

屬性	類型	默認(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欄可以切換頁面），那么我們可以通過 tabBar 配置項(xiàng)指定 tab 欄的表現(xiàn)，以及 tab 切換時(shí)顯示的對(duì)應(yīng)頁面。

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

屬性說明：

屬性	類型	必填	默認(rèn)值	描述
color	HexColor	是		tab 上的文字默認(rèn)顏色
selectedColor	HexColor	是		tab 上的文字選中時(shí)的顏色
backgroundColor	HexColor	是		tab 的背景色
borderStyle	String	否	black	tabbar上邊框的顏色，僅支持 black/white
list	Array	是		tab 的列表，詳見 list 屬性說明，最少2個(gè)、最多5個(gè) tab

其中 list 接受一個(gè)數(shù)組，數(shù)組中的每個(gè)項(xiàng)都是一個(gè)對(duì)象，其屬性值如下：

屬性	類型	必填	說明
pagePath	String	是	頁面路徑，必須在 pages 中先定義
text	String	是	tab 上按鈕文字
iconPath	String	是	圖片路徑，icon 大小限制為40kb
selectedIconPath	String	是	選中時(shí)的圖片路徑，icon 大小限制為40kb

networkTimeout

可以設(shè)置各種網(wǎng)絡(luò)請(qǐng)求的超時(shí)時(shí)間。

屬性說明：

屬性	類型	必填	說明
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

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

page.json

每一個(gè)小程序頁面也可以使用.json文件來對(duì)本頁面的窗口表現(xiàn)進(jìn)行配置。頁面的配置比app.json全局配置簡單得多，只是設(shè)置 app.json 中的 window 配置項(xiàng)的內(nèi)容，頁面中配置項(xiàng)會(huì)覆蓋 app.json 的 window 中相同的配置項(xiàng)。
頁面的.json只能設(shè)置 window 相關(guān)的配置項(xiàng)，以決定本頁面的窗口表現(xiàn)，所以無需寫 window 這個(gè)鍵，如：

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

感謝閱讀，希望能幫助到大家，謝謝大家對(duì)本站的支持！

您可能感興趣的文章: