tencent cloud

Page Configuration
Download PDF
Last updated: 2025-07-25 18:16:11
Page Configuration
Last updated: 2025-07-25 18:16:11
Download PDF
Some of the configurations in app.json can also be configured for individual pages. You can configure the performance of the page in the corresponding .json file.
The configurations in the page will override the same configurations in app.json on the current page (style-related configurations are part of the window attribute in app.json, but you don't need to specify the window field here), and you can refer to the global configuration for the values and meanings of the configurations.
The content of the file is a JSON object with the following properties:

Configuration item

attribute
type
default
describe
navigationBarBackgroundColor
HexColor
#000000
Navigation bar background color, such as #000000
navigationBarTextStyle
string
white
Navigation bar header color, support only black / white
navigationBarTitleText
string

Navigation Title Text Content
navigationStyle
string
default
Navigation bar style supports only the following values
default Default style, includes native navigation bar and capsule buttons.
custom Customize the navigation bar, leaving only the capsule on in the upper right corner. It does not take effect on the page where the web-view is located.
hide Hide the navigation bar and capsule buttons. It only hides the capsule buttons on the page where the web-view is located.
customV2 Customize the navigation bar, leaving only the capsule on in the upper right corner.
hideV2 Hide the navigation bar and capsule buttons.
See note 1, note 2.
backgroundColor
HexColor
#ffffff
The background color of the window
backgroundTextStyle
string
dark
Pull down loading Style, only supports dark / light
backgroundColorTop
string
#ffffff
The background color of the top window, only iOS Support
backgroundColorBottom
string
#ffffff
The background color of the bottom window, only iOS Support
enablePullDownRefresh
boolean
false
Whether to enable the current page drop-down refresh. See for details Page.onPullDownRefresh
onReachBottomDistance
number
50
The distance, in px, from the bottom of the page when the pull-down event is triggered. See for details Page.onReachBottom
pageOrientation
string
portrait
Screen rotation settings, support car / portrait / landscape See for details Response to display area changes
disableScroll
boolean
false
Set to true The page cannot scroll up and down as a whole. Valid only in page configuration, not in app.json Set in
usingComponents
Object
no
page Custom Components configuration
note 1: The minimum version requirements for customV2 and hideV2 in the navigationStyle valid values are as follows:
IDE
Base Library
iOS SDK
Android SDK
2.2.611
2.2.6
2.2.6
2.2.6
note 2: The values and display scenarios of navigationStyle are as follows:
navigationStyle
Regular page
Page with web-view
default




custom



hide




customV2




hideV2





Note：
Not all configurations in app.json can be overridden or specified separately on the page, limited to the options included in this document.

Configuration example

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

Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback