頁面配置
app.json中的部分配置,也支持對單個頁面進行配置,可以在頁面對應的.json文件來對本頁面的表現進行配置。
頁面中配置項在當前頁面會覆蓋app.json中相同的配置項(樣式相關的配置項屬於app.json中的window内容,但這裡不需要額外指定window欄位),具體的取值和含義可參攷 全局配置 中說明。
文件內容為一個JSON對象,有以下内容:
配置項
| 内容 | 類型 | 必填 | 描述 |
|---|---|---|---|
| navigationBarBackgroundColor | HexColor | #000000 | 導航欄背景顏色,如#000000 |
| navigationBarTextStyle | string | white | 導航欄標題、狀態列顏色,僅支持: black / white |
| navigationBarTitleText | string | 導航欄標題文字內容 | |
| navigationStyle | string | default | 導航欄樣式,僅支持以下值: -default默認樣式 -custom自定義導航欄,只保留右上角膠囊按鈕 -hide自定義導航欄,可以支持隱私導航欄和膠囊按鈕。 參見表格後緊接的注2 |
| backgroundColor | HexColor | #ffffff | 視窗的背景色 |
| backgroundTextStyle | string | dark | 下拉loading的樣式,僅支持dark / light |
| backgroundColorTop | string | #ffffff | 頂部視窗的背景色,僅iOS支持 |
| backgroundColorBottom | string | #ffffff | 頂部視窗的背景色,僅iOS支持 |
| enablePullDownRefresh | boolean | false | 是否開啟當前頁面下拉刷新 詳見 Page.onPullDownRefresh |
| onReachBottomDistance | number | 50 | 頁面上拉觸底事件觸發時距頁面底部距離,單位為px 詳見 Page.onReachBottom |
| pageOrientation | string | portrait | 荧幕旋轉設定,支持auto / portrait / landscape 詳見 響應顯示區域變化 |
| disableScroll | boolean | false | 設定為true則頁面整體不能上下滾動,只在頁面配置中有效,無法在app.json中設定 |
| usingComponents | Object | 否 | 頁面 自定義組件 配置 |
TIP
並不是所有app.json中的配置都可以在頁面覆蓋或單獨指定,僅限於本文件包含的選項。
配置示例:
js
{
"navigationBarBackgroundColor": "#ffffff",
"navigationBarTextStyle": "black",
"navigationBarTitleText": "WeChat interface function demonstration,"
"backgroundColor": "#eeeeee",
"backgroundTextStyle": "light"
}