Skip to content

頁面配置

app.json中的部分配置,也支持對單個頁面進行配置,可以在頁面對應的.json文件來對本頁面的表現進行配置。

頁面中配置項在當前頁面會覆蓋app.json中相同的配置項(樣式相關的配置項屬於app.json中的window内容,但這裡不需要額外指定window欄位),具體的取值和含義可參攷 全局配置 中說明。

文件內容為一個JSON對象,有以下内容:

配置項

内容類型必填描述
navigationBarBackgroundColorHexColor#000000導航欄背景顏色,如#000000
navigationBarTextStylestringwhite導航欄標題、狀態列顏色,僅支持: black / white
navigationBarTitleTextstring導航欄標題文字內容
navigationStylestringdefault導航欄樣式,僅支持以下值: -default默認樣式 -custom自定義導航欄,只保留右上角膠囊按鈕 -hide自定義導航欄,可以支持隱私導航欄和膠囊按鈕。 參見表格後緊接的注2
backgroundColorHexColor#ffffff視窗的背景色
backgroundTextStylestringdark下拉loading的樣式,僅支持dark / light
backgroundColorTopstring#ffffff頂部視窗的背景色,僅iOS支持
backgroundColorBottomstring#ffffff頂部視窗的背景色,僅iOS支持
enablePullDownRefreshbooleanfalse是否開啟當前頁面下拉刷新 詳見 Page.onPullDownRefresh
onReachBottomDistancenumber50頁面上拉觸底事件觸發時距頁面底部距離,單位為px 詳見 Page.onReachBottom
pageOrientationstringportrait荧幕旋轉設定,支持auto / portrait / landscape 詳見 響應顯示區域變化
disableScrollbooleanfalse設定為true則頁面整體不能上下滾動,只在頁面配置中有效,無法在app.json中設定
usingComponentsObject頁面 自定義組件 配置

TIP

並不是所有app.json中的配置都可以在頁面覆蓋或單獨指定,僅限於本文件包含的選項。

配置示例:

js
{
  "navigationBarBackgroundColor": "#ffffff",
  "navigationBarTextStyle": "black",
  "navigationBarTitleText": "WeChat interface function demonstration,"
  "backgroundColor": "#eeeeee",
  "backgroundTextStyle": "light"
}