开发 .json 文件

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

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

# 配置示例

代码示例

{
    "navigationBarBackgroundColor": "#ffffff",
    "navigationBarTextStyle": "black",
    "navigationBarTitleText": "智能小程序接口功能演示",
    "backgroundColor": "#eeeeee",
    "backgroundTextStyle": "light"
}

# 页面配置项列表

属性 类型 默认值 描述 最低版本
navigationBarBackgroundColor HexColor #000000 导航栏背景颜色,如 #000000
navigationBarTextStyle String white 导航栏标题颜色,有效值 black / white
navigationBarTitleText String -- 导航栏标题文字内容
navigationStyle String default 导航栏样式,有效值:default(默认样式) custom(自定义导航栏),只保留右上角胶囊按钮,在页面级配置优先级高于全局配置 iOS 基础库版本 3.0.39, Android 基础库版本 2.10.34
backgroundColor HexColor #ffffff 窗口的背景色
backgroundTextStyle String dark 下拉 loading 的样式,有效值 dark / light
enablePullDownRefresh Boolean false 是否全局开启下拉刷新。详见 Page.onPullDownRefresh
onReachBottomDistance Number 50 页面上拉触底事件触发时距页面底部距离,单位为px。详见Page.onReachBottom
disableScroll Boolean false 设置为 true 则页面整体不能上下滚动。只在页面配置中有效,无法在 app.json 中设置 Android暂不支持

说明:

  • 页面的.json只能设置 window 相关的配置项,以决定本页面的窗口表现,所以无需写 window 这个键;
  • navigationStyle 全局配置AndroidiOS从基础库版本 2.10.34 开始支持, 但子页面配置支持情况Android基础库版本2.10.34开始支持,iOS基础库版本 3.0.39开始支持, 做低版本兼容时,通过 swan.getSystemInfo 或者 swan.getSystemInfoSync 获取百度APP版本号进行兼容判断,具体见下表;
  • 无其它特殊说明,请使用canIUse或者SWAN基础库版本进行兼容判断。

navigationStyle配置

顶bar设置 iOS Android WebView组件页面 备注
百度APP定义的顶bar 无版本限制 无版本限制 无版本限制
顶bar全局透明设置 基础库版本 2.10.34 基础库版本 2.10.34 不生效
顶bar子页面透明设置 基础库版本 3.0.39 基础库版本 2.10.34 不生效 每个page的json文件可以单独配置navigationStyle

适配提示

原生顶bar高度=状态栏高度(statusBarHeight)+顶部导航栏高度(navigationBarHeight);可通过 swan.getSystemInfo 或者 swan.getSystemInfoSync 获取。