微信小程序开发文档 微信小程序导航 navigation-bar

2024-02-25 开发教程 微信小程序开发文档 匿名 7

functional-page-navigator

基础库 2.9.0 开始支持,低版本需做兼容处理。

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

通过这个节点可以获得类似于调用 wx.setNavigationBarTitle wx.setNavigationBarColor 等接口调用的效果。

属性类型默认值必填说明最低版本
titlestring导航条标题2.9.0
loadingbooleanfalse是否在导航条显示 loading 加载提示2.9.0
front-colorstring

导航条前景颜色值,包括按钮、标题、状态栏的颜色,仅支持 #ffffff#000000

2.9.0
background-colorstring导航条背景颜色值,有效值为十六进制颜色2.9.0
color-animation-durationnumber0改变导航栏颜色时的动画时长,默认为 0(即没有动画效果)2.9.0
color-animation-timing-funcnumber"linear"

改变导航栏颜色时的动画方式,支持 lineareaseIneaseOuteaseInOut

2.9.0

示例代码

<page-meta>
<navigation-bar
title="{{nbTitle}}"
loading="{{nbLoading}}"
front-color="{{nbFrontColor}}"
background-color="{{nbBackgroundColor}}"
color-animation-duration="2000"
color-animation-timing-func="easeIn"
/>
</page-meta>
Page({
data: {
nbFrontColor: '#000000',
nbBackgroundColor: '#ffffff',
},
onLoad() {
this.setData({
nbTitle: '新标题',
nbLoading: true,
nbFrontColor: '#ffffff',
nbBackgroundColor: '#000000',
})
}
})