小程序开放平台

文档中心
小程序配置
全局配置
页面配置
框架接口
XHSML语法参考
2.0架构升级
sjs 语法参考
平台骨架屏(beta)

页面配置

开发
>
框架
>
小程序配置
>
页面配置
>
更新时间:2025-07-30 18:08:28

每一个小程序页面也可以使用

.json
文件来对本页面的窗口表现进行配置。页面中配置项在当前页面会覆盖
app.json
window
中相同的配置项。文件内容为一个 JSON 对象,有以下属性:

配置项

属性
类型
默认值
描述
最低版本
navigationBarBackgroundColorHexColor#000000导航栏背景颜色,如 #000000
navigationBarTextStylestringwhite导航栏标题颜色,仅支持 black / white
navigationBarTitleTextstring导航栏标题文字内容
navigationStylestringdefault导航栏样式,仅支持以下值:default 默认样式custom 自定义导航栏,只保留右上角胶囊按钮。
backgroundColorHexColor#ffffff窗口的背景色
enablePullDownRefreshbooleanfalse是否开启当前页面下拉刷新
onReachBottomDistancenumber50页面上拉触底事件触发时距页面底部距离,单位为px
pageOrientationstringportrait屏幕旋转设置,支持 auto / portrait / landscape
disableScrollbooleanfalse设置为 true 则页面整体不能上下滚动。只在页面配置中有效,无法在 app.json 中设置
usingComponentsObject页面自定义组件配置
该文档是否对您有帮助?