菜鸡源码,专注精品下载!
当前位置:首页 > 建站教程 > 建站知识

API文档说明:底部导航栏(tabBar)

发布时间:2024-01-05  栏目:建站知识   浏览:   分类:微信小程序教程 微信小程序api

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 按数组的顺序排序。

属性说明:

属性类型必填默认值描述colorHexColor是
tab 上的文字默认颜色selectedColorHexColor是
tab 上的文字选中时的颜色backgroundColorHexColor是
tab 的背景色borderStyleString否blacktabbar上边框的颜色, 仅支持 black/whitelistArray是
tab 的列表,详见 list 属性说明,最少2个、最多5个 tabpositionString否bottom可选值 bottom、top

其中 list 接受一个数组,数组中的每个项都是一个对象,其属性值如下:

属性类型必填说明pagePathString是页面路径,必须在 pages 中先定义textString是tab 上按钮文字iconPathString是图片路径,icon 大小限制为40kbselectedIconPathString是选中时的图片路径,icon 大小限制为40kb 相关专题

相关文章

    无相关信息
评论
建站知识
建站知识
使用技巧
调试安装
运营推广