微信小程序開發教程（六）配置——app.json、page.json詳解

全局配置：app.json

　　微信小程序的全局配置保存在app.json文件中。開發者通過使用app.json來配置頁面文件（pages）的路徑、窗口（window）表現、設定網絡超時時間值（networkTimeout）以及配置多個切換頁（tarBar）等。

　　首先看一個典型的全局配置app.json文件

{
  "pages": [
    "pages/index/index",
    "pages/logs/logs",
    "pages/demo/demo"
  ],
  "window": {
    "backgroundTextStyle": "light",
    "navigationBarBackgroundColor": "#fff",
    "navigationBarTitleText": "WeChat",
    "navigationBarTextStyle": "black"
  },
  "tarBar": {
    "list": [{
      "pagePath":"pages/index/index",
      "text": "首頁"
    },{
      "pagePath": "pages/logs/logs",
      "text": "日志"
    },{
      "pagePath": "pages/demo/demo",
      "text": "demo"
    }]
  },
  "networkTimeout": {
    "request": 20000,
    "connectSocket": 20000,
    "uploadFile": 20000,
    "downloadFile": 20000
  },
  "debug":true
}

　　全局配置項及描述如下表：

　　

　　1.pages配置項

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

　　pages配置項要注意三點：

　　1）數組的第一項用於設定小程序的初始頁面。

　　2）小程序中新增/減少頁面，都需要對pages數組進行修改。

　　3）文件名不需要寫文件后綴。小程序框架會自動去尋找路徑.json、.js、.wxml、.wxss這四類文件進行整合。

 　　2.window配置項

　　用於設置小程序的狀態欄、導航條、標題、窗口等對象的顏色、背景色、內容屬性，非必填配置項。沒有配置時將使用默認值。window可配置的對象見下表。

　　

　　注:HexColor為十六進制顏色值類型，如“#ff00ff”

　　3.tarBar配置項

　　小程序可以是多標簽頁切換的應用，需要通過tarBar配置項來指定標簽頁的表現，及標簽頁切換時所顯示的對應頁面。

　　

　　tarBar配置項接受多個對象的設定，其中的對象list是一個數組，用於配置標簽頁。最少配置2個、最多配置5個，標簽頁按數組的順序排序。當設置 position 為 top 時，將不會顯示 icon。

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

　　

　　

　　4.networkTimeout配置項

　　networkTimeout配置項用於設置各種網絡請求對象的超時時間，非必須配置項。可設置的網絡請求超時的相關對象有request、connectSocket、uploadFile、downloadFile。超時的單位均為毫秒。這些超市若不設置，則默認使用操作系統內核或遵循服務器WebServer的設定值。

　　

　　5.debug配置項

　　debug配置項用於開啟開發者工具的調試模式，他接受一個boolean值（默認是false）。開啟后，頁面（page）的注冊、頁面路由、數據更新、事件觸發等調試信息將以info的形式，輸出在“調試”功能的console面板上。

　　注意：正式發布時應當關閉此配置項開關。

 

 

頁面配置：page.json

　　除了全局的app.json配置外，還可以用.json文件對小程序項目中的每一個頁面進行配置，但只能設置本頁面的window配置項的內容，頁面.json文件中的window配置值將覆蓋app.json中的配置值。