小工具知识网

当前位置: 首页 > 行业知识 > 微信小程序--》tabBar底部栏

行业知识

微信小程序--》tabBar底部栏

2026-11-12 13:17:09 来源:互联网转载

️作者���介:大家好,我是亦世凡华、渴望知识储备自己的一名在校大学生

个人主页:亦世凡华、

系列专栏:微信小程序

座右铭:人生亦可燃烧,亦可腐败,我愿燃烧,耗尽所有光芒。

引言

       ⚓经过web前端开发的学习,相信大家对于前端开发有了一定深入的了解,今天我开设了微信小程序专栏,主要想从移动端开发方向进一步发展,而对于我来说写移动端博文的第一站就是小程序开发,希望看到我文章的朋友能对你有所帮助。

目录

什么是tabBar

tabBar的6个组成部分

tabBar配置项

tab项的配置选项

自定义tabBar

配置信息

添加tabBar代码文件

编写tabBar代码

自定义tabBar图标

渲染tabBar的数字徽标

tabBar页面切换及其样式设置


什么是tabBar

tabBar是移动端应用常见的页面效果,用于实现多页面的快速切换。小程序中通常将其分成两类,分别是:底部 tabBar 和 顶部 tabBar 简言之:就是位于小程序底部或顶部的调整导航栏,与微信底部导航栏类似。

注意:

tabBar中只能配置最少2个、最多5个tab页签

当渲染顶部的tabBar时,不显示icon,只显示文本

tabBar的6个组成部分

①backgroundColor:tabBar的背景色

②selectedIconPath:选中时的图片路径

③borderStyle:tabBar上边框的颜色

④iconPath:未选中时的图片路径

⑤selectedColor:tab上的文字选中时的颜色

⑥color:tab上文字的默认(未选中)颜色

tabBar配置项

属性类型必填项默认值描述
positionString否bottomtabBar的位置,仅支持bottom/top
borderStyleString否blacktabBar上边框颜色,仅支持black/white
colorHexColor否无tab上文字的默认(未选中)颜色
selectedColorHexColor否无tab上文字的选中颜色
backgroundColorHexColor否无tabBar的背景色
listArray是无tab页签的列表(最少2个,最多5个)

tab项的配置选项

在list数组里面填写的tab页签,每个tab页签可以配置如下配置选项:

属性类型必填描述
pagePathString是页面路径,页面必须在pages中预先定义
textString是tab上显示的文字
iconPathString否未选中时的图标路径;当position为top时,不显示icon
selectedIconPathString否选中时的图标路径;当position为top时,不显示icon
{  "pages":[    "pages/home/home",    "pages/message/message",    "pages/contact/contact",    "pages/person/person",    "pages/index/index",    "pages/logs/logs"      ],  "window":{    "backgroundTextStyle":"dark",    "navigationBarBackgroundColor": "#008c8c",    "navigationBarTitleText": "我的微信小程序",    "navigationBarTextStyle":"white",    "enablePullDownRefresh": true,    "backgroundColor": "#0f0",    "onReachBottomDistance": 50  },  "tabBar": {    "list": [{      "pagePath": "pages/home/home",      "text": "首页",      "iconPath": "./images/home.png",      "selectedIconPath": "./images/home-active.png"    },    {      "pagePath": "pages/message/message",      "text": "消息",      "iconPath": "./images/message.png",      "selectedIconPath": "./images/message-active.png"    },    {      "pagePath": "pages/contact/contact",      "text": "联系我们",      "iconPath": "./images/contact.png",      "selectedIconPath": "./images/contact-active.png"    }]  },  "style": "v2",  "sitemapLocation": "sitemap.json"}

自定义tabBar

自定义 tabBar 可以让开发者更加灵活地设置 tabBar 样式,以满足更多个性化的场景。详细了解的话请参考官方文档说明:自定义tabBar

配置信息

官方文档明确说明:

为了保证低版本兼容以及区分哪些页面是 tab 页,tabBar 的相关配置项需完整声明,但这些字段不会作用于自定义 tabBar 的渲染,所有下图的list是不用删除的。

添加tabBar代码文件

注意:添加的文件夹名字必须要和官方文件名字一样,不能乱修改名字;然后右键文件夹选择新建Component输入index 即可。

只要我们在app.json中声明了custom:true同时又创建了对应的custom-tab-bar对应的文件结构,微信小程序会自动识别custom-tab-bar对应的组件,把它的结构渲染到页面上,当作我们的tabBar

编写tabBar代码

我们自定义 tabBar 可以通过 Vant 组件库 里面的 tabBar 标签栏样式来快速便捷的创建我们的tabBar代码,如何配置 Vant 组件库的具体过程就不在演示了,详情请看一下如下这篇文章:

Vant组件库的安装及使用

自定义tabBar图标

Vant组件库也为我们提供了具体的方法:可以通过 slot 自定义图标,其中 icon slot 代表未选中状态下的图标,icon-active slot 代表选中状态下的图标。

      首页

虽然我们可以自定义图标,但是上面的自定义一个图标就要写好多代码,能不能有种方法可以简便的自定义我们的图标,可以的。我们可以通过循环的形式将我们的tabbar-item给我们渲染出来。

首先我们需要将 list 里面的文件复制到自定义组件文件夹下 .js文件下的data里面:

// .wxml

上一篇:ASP.NET源码大揭秘,优质资源免费获取!

下一篇:怎么查询自己房子的网签备案