用于设置小程序的状态栏、导航条、标题、窗口背景色,其配置项如下。

    属性 类型 默认值 描述
    navigationBarBackgroundColor HexColor(十六进制颜色值) #000000 导航栏背景颜色,如 #000000
    navigationBarTextStyle String white 导航栏标题颜色,仅支持 black / white
    navigationBarTitleText String 导航栏标题文字内容
    navigationStyle String default 导航栏样式,仅支持以下值:default 默认样式;custom 自定义导航栏,只保留右上角胶囊按钮
    backgroundColor String 窗口的背景色
    backgroundTextStyle String dark 下拉 loading 的样式,仅支持 dark / light
    backgroundColorTop String #ffffff 顶部窗口的背景色,仅 iOS 支持
    backgroundColorBottom String #ffffff 底部窗口的背景色,仅 iOS 支持
    enablePullDownRefresh boolean false 是否开启当前页面的下拉刷新。
    onReachBottomDistance Number 50 页面上拉触底事件触发时距页面底部距离,单位为 px
    pageOrientation String portrait 屏幕旋转设置,支持 auto / portrait / landscape 详见 响应显示区域变化

    各端支持程度如下

    属性 微信小程序 百度小程序 字节跳动小程序 支付宝小程序 H5 RN
    navigationBarBackgroundColor ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
    navigationBarTextStyle ✔️ ✔️ ✔️ ✔️ ✔️
    navigationBarTitleText ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
    navigationStyle ✔️(微信客户端 6.6.0) ✔️(百度 App 版本 11.1.0) ✔️
    backgroundColor ✔️ ✔️ ✔️ ✔️
    backgroundTextStyle ✔️ ✔️ ✔️
    backgroundColorTop ✔️(微信客户端 6.5.16) ✔️
    backgroundColorBottom ✔️(微信客户端 6.5.16) ✔️
    enablePullDownRefresh ✔️ ✔️ ✔️ ✔️
    onReachBottomDistance ✔️ ✔️ ✔️
    pageOrientation ✔️2.4.0 (auto) / 2.5.0 (landscape)

    微信小程序中,关于navigationStyle

    • 客户端 7.0.0 以下版本,navigationStyle 只在 app.json 中生效。
    • 客户端 6.7.2 版本开始,navigationStyle: custom 对 组件无效
    • 开启 custom 后,低版本客户端需要做好兼容。开发者工具基础库版本切到 1.7.0(不代表最低版本,只供调试用)可方便切到旧视觉

    image.png