window
用於設置小程序的狀態欄、導航條、標題、窗口背景色。
| 屬性 | 類型 | 默認值 | 描述 | 最低版本 |
|---|---|---|---|---|
| navigationBarBackgroundColor | HexColor | #000000 | 導航欄背景顏色,如 #000000 |
|
| navigationBarTextStyle | string | white | 導航欄標題顏色,僅支持 black / white |
|
| navigationBarTitleText | string | 導航欄標題文字內容 | ||
| navigationStyle | string | default | 導航欄樣式,僅支持以下值:default 默認樣式custom 自定義導航欄,只保留右上角膠囊按鈕。參見注 2。 |
微信客戶端 6.6.0 |
| backgroundColor | HexColor | #ffffff | 窗口的背景色 | |
| backgroundTextStyle | string | dark | 下拉 loading 的樣式,僅支持 dark / light |
|
| backgroundColorTop | string | #ffffff | 頂部窗口的背景色,僅 iOS 支持 | 微信客戶端 6.5.16 |
| backgroundColorBottom | string | #ffffff | 底部窗口的背景色,僅 iOS 支持 | 微信客戶端 6.5.16 |
| enablePullDownRefresh | boolean | false | 是否開啟全局的下拉刷新。 詳見 Page.onPullDownRefresh |
|
| onReachBottomDistance | number | 50 | 頁面上拉觸底事件觸發時距頁面底部距離,單位為 px。 詳見 Page.onReachBottom |
|
| pageOrientation | string | portrait | 屏幕旋轉設置,支持 auto / portrait / landscape詳見 響應顯示區域變化 |
2.4.0 (auto) / 2.5.0 (landscape) |
- 注 1:HexColor(十六進制顏色值),如"#ff00ff"
- 注 2:關於
navigationStyle- 客戶端 7.0.0 以下版本,
navigationStyle只在app.json中生效。 - 客戶端 6.7.2 版本開始,
navigationStyle: custom對 web-view 組件無效 - 開啟 custom 后,低版本客戶端需要做好兼容。開發者工具基礎庫版本切到 1.7.0(不代表最低版本,只供調試用)可方便切到舊視覺
- 客戶端 7.0.0 以下版本,
如:
{ "window": { "navigationBarBackgroundColor": "#ffffff", "navigationBarTextStyle": "black", "navigationBarTitleText": "微信接口功能演示", "backgroundColor": "#eeeeee", "backgroundTextStyle": "light" } }

