微信小程序 app.json 配置

咱們使用app.json文件來對微信小程序進行全局配置，決定頁面文件的路徑、窗口表現、設置網絡超時時間、設置多 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

接受一個數組，每一項都是字符串，來指定小程序由哪些頁面組成。每一項表明對應頁面的【路徑+文件名】信息，

• 數組的第一項表明小程序的初始頁面。小程序中新增/減小頁面，都須要對 pages 數組進行修改。
• 文件名不須要寫文件後綴，由於框架會自動去尋找路徑.json,.js,.wxml,.wxss的四個文件進行整合。

如開發目錄爲：

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

用於設置小程序的狀態欄、導航條、標題、窗口背景色。

 

如 app.json ：注：HexColor（十六進制顏色值），如"#ff00ff"

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

　　

tabBar

若是咱們的小程序是一個多 tab 應用（客戶端窗口的底部或頂部有 tab 欄能夠切換頁面），那麼咱們能夠經過 tabBar 配置項指定 tab 欄的表現，以及 tab 切換時顯示的對應頁面。

Tip： 經過頁面跳轉（wx.navigateTo）或者頁面重定向（wx.redirectTo）所到達的頁面，即便它是定義在 tabBar 配置中的頁面，也不會顯示底部的 tab 欄。

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

屬性說明：

 

其中 list 接受一個數組，數組中的每一個項都是一個對象，其屬性值以下：

 

networkTimeout

能夠設置各類網絡請求的超時時間。

debug

能夠在開發者工具中開啓 debug 模式，在開發者工具的控制檯面板，調試信息以 info 的形式給出，其信息有Page的註冊，頁面路由，數據更新，事件觸發 。 能夠幫助開發者快速定位一些常見的問題。

page.json

每個小程序頁面也能夠使用.json文件來對本頁面的窗口表現進行配置。 頁面的配置比app.json全局配置簡單得多，只是設置 app.json 中的 window 配置項的內容，頁面中配置項會覆蓋 app.json 的 window 中相同的配置項。

頁面的.json只能設置 window 相關的配置項，以決定本頁面的窗口表現，因此無需寫 window 這個鍵，如：

 

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