微信小程序底部实现自定义动态Tabbar

2023-07-21 22:43:52

多图警告！！！

最近在工作中遇到这样一个需求：微信小程序底部的Tab需要通过判断登录人的角色动态进行改变，想要实现这个功能依靠小程序原生的Tabbar是不可能实现的了，所以研究了一下自定义Tab，这里记录一下

微信小程序的Tab

想要写自定义Tab首先要知道原生Tab该怎么写，新建一个微信小程序运行起来，默认是这个样子的

简单修改一下小程序自带的logs页面，大概是这个样子（通过两个按钮模拟角色，就不写登录了）

目前想要在两个页面之前来回切换只能通过修改app.json中pages的顺序才能实现，所以我们需要底部的Tab，官方文档中对Tab的使用有详细介绍，我这里选择在app.json中添加tabBar实现：

// app.json文件中pages同级的位置增加tabBar来配置底部Tab
"tabBar": {
  // 文字默认颜色
  "color": "#5F5F5F",
  // 文字选中颜色
  "selectedColor": "#027FF5",
  // Tab背景颜色
  "backgroundColor": "#F7F7F7",
  // Tab列表
  "list": [{
      // Tab默认图标
      "iconPath": "/images/footer-01.png",
      // Tab选中图标
      "selectedIconPath": "/images/footer-01-h.png",
      // Tab跳转的目标路径，参考上面的pages属性即可
      "pagePath": "pages/index/index",
      // Tab底部显示的文字
      "text": "首页"
    }, {
      "iconPath": "/images/footer-03.png",
      "selectedIconPath": "/images/footer-03-h.png",
      "pagePath": "pages/logs/logs",
      "text": "测试页"
  }]
},

这样一来就可以通过点击底部Tab来切换显示页面了，这就是微信小程序的Tab

自定义Tab

针对自定义Tab 官方文档中也有详细说明，需要在根目录创建一个组件(Component)，名称要固定写好：

然后在app.json中找到之前添加的tabBar属性，在他下面添加这样一个属性：

之后就会发现底部Tab已经变成了刚刚创建的组件，接下来就开始绘制Tab页

官方建议绘制Tab时最好使用cover-view + cover-image标签搭配flex布局，保证Tab层级较高

这样一来自定义的Tab就已经成功了一半了，接下来就要结合JS让他称为真正的Tab，为了让自定义Tab使用起来更顺手，这里按照app.json的tab格式将配置粘贴到JS文件中，然后修改下wxml让页面数据变成动态的，这样Tab列表的功能就完成了！

然后要实现Tab点击切换页面的核心功能，我们在每个Tab上添加一个点击事件，然后将需要跳转的目标路径传入到跳转方法中，然后页面跳转就实现了

接下来实现的是页面Tab高亮，之前在wxml中已经写了根据index判断的条件，接下来只需要在访问页面时记录tabIndex就没问题了

这样乍一看的确实现了高亮的效果，但是当仔细观察后就会发现，只有在第二次点击的时候高亮才会同步过去，Tab更新不及时，所以这里不能采取这种方法，应该让页面来决定那个Tab应该高亮，将switchTab中的setData移除掉，分别在首页和测试页添加更新高亮的代码：

OK！这样自定义Tab就可以正常使用了！

动态Tab实现

准备工作做的差不多了，现在开始实现动态Tab，鉴于在之前设置高亮的时候发现了Tab中数据更新不及时的问题，以及每个Page的onShow中都会调用重复代码，这里决定书写一个服务将Tab常用操作都封装进去，在utils文件夹下新建tab-service.js，跟Tab相关的东西都放到这个下面：

// Tab页的data
let tabData = {
    tabIndex: 0,
    tabBar: {
        custom: true,
        color: "#5F5F5F",
        selectedColor: "#027FF5",
        backgroundColor: "#F7F7F7",
        list: [{
            iconPath: "/images/footer-01.png",
            selectedIconPath: "/images/footer-01-h.png",
            pagePath: "pages/index/index",
            text: "首页"
        }, {
            iconPath: "/images/footer-03.png",
            selectedIconPath: "/images/footer-03-h.png",
            pagePath: "pages/logs/logs",
            text: "测试页"
        }]
    }
}

// 更新角色
const updateRole = (that, role) => {
    tabData.tabBar.list[0].text = role + "首页";
    updateTab(that);
}

// 更新底部高亮
const updateIndex = (that, index) => {
    tabData.tabIndex = index;
    updateTab(that);
}

// 更新Tab状态
const updateTab = (that) => {
    if (typeof that.getTabBar === 'function' && that.getTabBar()) {
        that.getTabBar().setData(tabData);
    }
}

// 将可调用的方法抛出让外面调用
module.exports = {
    updateRole, updateTab, updateIndex
}

之前说了那么多，这里动态Tab细节就不多说了，点击下载代码看看就懂了

码农公寓

微信小程序的Tab

自定义Tab

动态Tab实现

相关文章