小程式全域性配置、頁面配置引數說明
阿新 • • 發佈:2018-12-19
全域性配置
屬性 | 型別 | 必填 | 描述 | 支援版本 |
---|---|---|---|---|
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 這個鍵。