最近在工作中遇到这样一个需求:微信小程序底部的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细节就不多说了,点击下载代码 看看就懂了
发表评论 取消回复