文档

# 页面配置

每一个小程序页面也可以使用.json文件来对本页面的窗口表现进行配置。

页面的配置只能设置 app.json 中部分 window 配置项的内容，页面中配置项会覆盖 app.json 的 window 中相同的配置项。

# 配置示例

{
  "navigationBarBackgroundColor": "#ffffff",
  "navigationBarTextStyle": "black",
  "navigationBarTitleText": "QQ接口功能演示",
  "backgroundColor": "#eeeeee",
  "backgroundTextStyle": "light"
}
1
2
3
4
5
6
7

# 页面配置项列表

属性 类型 默认值 描述 最低版本
navigationBarBackgroundColor HexColor #000000 导航栏背景颜色，如 #000000
navigationBarTextStyle String white 导航栏标题颜色，仅支持 black / white
navigationBarTitleText String 导航栏标题文字内容
navigationStyle String default 导航栏样式，仅支持以下值： default 默认样式 custom 自定义导航栏，只保留右上角胶囊按钮
backgroundColor HexColor #ffffff 窗口的背景色
backgroundTextStyle String dark 下拉 loading 的样式，仅支持 dark / light
backgroundColorTop String #ffffff 顶部窗口的背景色，仅 iOS 支持
backgroundColorBottom String #ffffff 底部窗口的背景色，仅 iOS 支持
enablePullDownRefresh Boolean false 是否全局开启下拉刷新。 详见 Page.onPullDownRefresh
pageOrientation String portrait 屏幕旋转设置，支持 auto / portrait / landscape 详见 响应显示区域变化

页面的.json只能设置 window 相关的配置项，以决定本页面的窗口表现，所以无需写 window 这个属性。

提示

PC程序窗体顶部会预留一个10px高度的窗口拖拽条，该条默认显示为白色，如果全局或当前页面设置了navigationBarBackgroundColor字段，则该拖拽条会使用navigationBarBackgroundColor指定的色值。

← 逻辑层 →