API文档说明:底部导航栏(tabBar)
tabBar底部导航API是微信小程序提供的一种页面导航方式,用于在小程序底部展示一组按钮,用户tabBar底部导航API是微信小程序提供的一种页面导航方式,用于在小程序底部展示一组按钮,用户可以通过点击这些按钮在不同的页面之间进行切换。每个按钮上可以显示文本或图标,也可以设置选中时的特殊效果。开发者可以通过配置 tabBar 对象来自定义底部导航栏的样式和功能。此外,tabBar 还支持一些事件回调,如切换到某个页面时触发 onTabItemTap 事件。需要注意的是,tabBar 只能配置在 app.json 中全局生效,如果需要局部配置,可以使用 custom-tab-bar 组件。
微信小程序tabBar是在全局app.JSON文件里面配置的,小程序tabBar配置代码注解说明。
{"pages":["pages/index/index","pages/detail/detail"],"window":{"navigationBarTitleText":"TabBar","navigationBarBackgroundColor":"#F60","navigationBarTextStyle":"white"},//tabBar注意是B是大写,有朋友提问运行时tab没出现,检查是不是这里手误"tabBar":{//文档指出color是必填项,其实可为空,不重写color就是深灰,样式更统一"color":"#ddd",//同样,文档指出selectedColor是必填项,不过selectedColor有必要重写,区分当前项与普通项"selectedColor":"#3cc51f",//同样,文档指出color是必填项,其实可为空,不重写backgroundColor就是浅灰,样式更统一。"backgroundColor":"#fff",//borderStyle,不写默认就是黑,那就黑好了,white的话,会少一条分隔线,跟页面混在一起了"borderStyle":"black","list":[{"pagePath":"pages/index/index",//iconPath图标是非必填,只是tab栏会变矮,自然selectedIconPath也可不写"iconPath":"image/icon_API.png","selectedIconPath":"image/icon_API_HL.png","text":"index"},{"pagePath":"pages/detail/detail","iconPath":"image/icon_component.png","selectedIconPath":"image/icon_component_HL.png","text":"detail"}]}}
参数说明
如果我们的小程序是一个多 tab 应用(客户端窗口的底部有tab栏可以切换页面),那么我们可以通过 tabBar 配置项指定 tab 栏的表现,以及 tab 切换时显示的对应页面。
tabBar 是一个数组,只能配置最少2个、最多5个 tab,tab 按数组的顺序排序。
属性说明:
tab 上的文字默认颜色selectedColorHexColor是
tab 上的文字选中时的颜色backgroundColorHexColor是
tab 的背景色borderStyleString否blacktabbar上边框的颜色, 仅支持 black/whitelistArray是
tab 的列表,详见 list 属性说明,最少2个、最多5个 tabpositionString否bottom可选值 bottom、top
其中 list 接受一个数组,数组中的每个项都是一个对象,其属性值如下: