1. 程式人生 > >小程式全域性配置、頁面配置引數說明

小程式全域性配置、頁面配置引數說明

全域性配置

屬性 型別 必填 描述 支援版本
pages String Array 頁面路徑列表
Object 全域性的預設視窗表現
Object 底部 tab 欄的表現
debug Boolean 是否開啟 debug 模式,預設關閉
Boolean 是否啟用外掛功能頁,預設關閉 2.1.0
Object Array 分包結構配置 1.7.3
String Worker 程式碼放置的目錄
Object 使用到的外掛 1.9.6
Object 分包預下載規則 2.3.0
Boolean iPad 小程式是否支援螢幕旋轉,預設關閉 2.3.0
配置示例

以下是一個包含了部分常用配置選項的 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
}

頁面配置

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

頁面的配置只能設定 app.json 中部分 window 配置項的內容,頁面中配置項會覆蓋 app.json 的 window 中相同的配置項。

頁面配置項列表
屬性 型別 預設值 描述
navigationBarBackgroundColor HexColor #000000 導航欄背景顏色,如 #000000
navigationBarTextStyle String white 導航欄標題顏色,僅支援 black / white
navigationBarTitleText String 導航欄標題文字內容
backgroundColor HexColor #ffffff 視窗的背景色
backgroundTextStyle String dark 下拉 loading 的樣式,僅支援 dark / light
enablePullDownRefresh Boolean false
onReachBottomDistance Number 50 頁面上拉觸底事件觸發時距頁面底部距離,單位為px。詳見 Page.onReachBottom
disableScroll Boolean false 設定為 true 則頁面整體不能上下滾動;只在頁面配置中有效,無法在 app.json 中設定該項
配置示例
{
  "navigationBarBackgroundColor": "#ffffff",
  "navigationBarTextStyle": "black",
  "navigationBarTitleText": "微信介面功能演示",
  "backgroundColor": "#eeeeee",
  "backgroundTextStyle": "light"
}

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