页面导航条配置节点,用于指定导航栏的一些属性。
只能是 page-meta 组件内的第一个节点,需要配合它一同使用。

平台差异说明

App H5 微信小程序 支付宝小程序 百度小程序 字节跳动小程序 QQ小程序
√ 2.6.3+ 2.6.3+ √ 2.9.0+

从HBuilderX 2.9.3起,编译到所有平台均支持navigation-bar,但编译到微信时,受微信基础库版本限制;编译到其他平台不受平台版本限制。

属性说明

属性 类型 默认值 必填 说明 最低版本
title string 导航条标题 微信基础库 2.9.0
title-icon string App 2.6.7+
titleIcon-radius string App 2.6.7+
subtitle-text string App 2.6.7+
subtitle-size string App 2.6.7+
subtitle-color string App 2.6.7+
subtitle-overflow string App 2.6.7+
title-align string App 2.6.7+
background-image string App 2.6.7+
background-repeat string App 2.6.7+
blur-effect string App 2.6.7+
loading string false 是否在导航条显示 loading 加载提示 微信基础库 2.9.0
front-color string 导航条前景颜色值,包括按钮、标题、状态栏的颜色,仅支持 #ffffff 和 #000000 微信基础库 2.9.0
background-color string 导航条背景颜色值,有效值为十六进制颜色 微信基础库 2.9.0
color-animation-duration number 0 改变导航栏颜色时的动画时长,默认为 0 (即没有动画效果) 微信基础库 2.9.0
color-animation-timing-func string “linear” 改变导航栏颜色时的动画方式,支持 linear 、 easeIn 、 easeOut 和 easeInOut 微信基础库 2.9.0

属性说明 /collocation/pages?id=app-titlenview

注意

  • navigation-bar 目前支持的配置仅为上表所列,并不支持 page.json 中关于导航栏的所有配置
  • navigation-bar 与 pages.json 的设置相冲突时,会覆盖 page.json 的配置

    示例代码

    1. <template>
    2. <page-meta>
    3. <navigation-bar
    4. :title="nbTitle"
    5. :titleIcon="titleIcon"
    6. :title-icon-radius="titleIconRadius"
    7. :subtitleText="subtitleText"
    8. :subtitle-color="nbFrontColor"
    9. :loading="nbLoading"
    10. :front-color="nbFrontColor"
    11. :background-color="nbBackgroundColor"
    12. :color-animation-duration="2000"
    13. color-animation-timing-func="easeIn"
    14. />
    15. </page-meta>
    16. <view class="content">
    17. </view>
    18. </template>
    19. <script>
    20. export default {
    21. data() {
    22. return {
    23. nbTitle: '标题',
    24. titleIcon: '/static/logo.png',
    25. titleIconRadius: '20px',
    26. subtitleText: 'subtitleText',
    27. nbLoading: false,
    28. nbFrontColor: '#000000',
    29. nbBackgroundColor: '#ffffff'
    30. }
    31. },
    32. onLoad() {
    33. },
    34. methods: {
    35. }
    36. }
    37. </script>