1. 程式人生 > >小程式進階(三)-----小程式的配置app.json

小程式進階(三)-----小程式的配置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
}

下面是部分關於這些引數的介紹 

 

下面我們對主要的幾個配置做一下介紹:
 

pages

用於指定小程式由哪些頁面組成,每一項都對應一個頁面的 路徑+檔名 資訊。檔名不需要寫檔案字尾,框架會自動去尋找對於位置的 .json.js.wxml.wxss 四個檔案進行處理。

陣列的第一項代表小程式的初始頁面(首頁)。小程式中新增/減少頁面,都需要對 pages 陣列進行修改。

如開發目錄為:

我們需要在 app.json 中寫 :

{
  "pages":[
    "pages/index/index",
    "pages/logs/logs"
  ]
}

第二個是window

用於設定小程式的狀態列、導航條、標題、視窗背景色。

注:HexColor(十六進位制顏色值),如"#ff00ff"

注:navigationStyle 只在 app.json 中生效。開啟 custom 後,低版本客戶端需要做好相容。開發者工具基礎庫版本切到 1.7.0(不代表最低版本,只供除錯用)可方便切到舊視覺

注:客戶端 6.7.2 版本開始,navigationStyle: custom 對 <web-view> 元件無效

 bi如說如 app.json :

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

下一個比較重要的是tabBar

如果小程式是一個多 tab 應用(客戶端視窗的底部或頂部有 tab 欄可以切換頁面),可以通過 tabBar 配置項指定 tab 欄的表現,以及 tab 切換時顯示的對應頁面。

 

其中 list 接受一個數組,只能配置最少2個、最多5個 tab。tab 按陣列的順序排序,每個項都是一個物件,其屬性值如下: 我們可以用這個來做我們小程式頂部或者是底部的功能選項:

 

 個人覺得官網的一張圖比較的形象標識的比較清楚:

在這之後就是關於網路延遲和debug的兩個了:

networkTimeout

各類網路請求的超時時間,單位均為毫秒。

debug

可以在開發者工具中開啟 debug 模式,在開發者工具的控制檯面板,除錯資訊以 info 的形式給出,其資訊有Page的註冊,頁面路由,資料更新,事件觸發等。可以幫助開發者快速定位一些常見的問題。

頁面配置

每一個小程式頁面也可以使用.json檔案來對本頁面的視窗表現進行配置。

頁面的配置只能設定 app.json 中部分 window 配置項的內容,頁面中配置項會覆蓋 app.json 的 window 中相同的配置項。比如說下面的程式碼:

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

 這裡就對導航欄的背景顏色,標題的文字內容和顏色,下拉的樣式進行了簡單的描述;

頁面的.json只能設定window相關的配置項,以決定本頁面的視窗表現,所以無需寫window這個鍵。但是也可以寫上;