微信小程序自定义tab，多层tab嵌套实现
小程序最近是越来越火了……
做小程序有一段时间了，总结一下项目中遇到的问题及解决办法吧。
项目中有个多 tab 嵌套的需求，进入程序主界面下面有两个 tab，进入A模块后，A模块最底下又有多个tab，每个tab上又嵌了2-4个不等的tab。。。
这种变态需求只能自定义tab了。
其实如果项目不是很复杂，没有多tab嵌套的需求，完全可以用小程序官方的 tabBar，方便快捷。
官方 tabBar 地址：https://developers.weixin.qq.com/miniprogram/dev/framework/config.html
一、Demo结构
先看效果图吧
image
image
结构是这样的：程序主界面包含两个 tab：主页和我的，主页又包含两个tab：最热和最新；我的也包含两个tab：电影和音乐。
关系图如下：
项目
主页
最热
最新
我的
电影
音乐
二、开始撸代码
再看代码结构
image
两种页面结构
小程序的页面分为两种：page 和 components。
page就是普通的页面， components是小程序为实现模块化而提供的自定义组件。
相同点：
都由四个文件：.js、.json、.wxml、.wxss、构成，.wxml、.wxss写法完全相同。
不同点：
-
components要在json文件中注明："component": true
{
"component": true,
"usingComponents": {
"movie": "movie/movie",
"music": "music/music"
}
}
-
js文件的结构和生命周期函数不同
下面是自动生成的page和components代码，可以感受下
page 的 js 代码
Page({
/**
* 页面的初始数据
*/
data: {
},
/**
* 生命周期函数--监听页面加载
*/
onLoad: function (options) {
},
/**
* 生命周期函数--监听页面初次渲染完成
*/
onReady: function () {
},
/**
* 生命周期函数--监听页面显示
*/
onShow: function () {
},
/**
* 生命周期函数--监听页面隐藏
*/
onHide: function () {
},
/**
* 生命周期函数--监听页面卸载
*/
onUnload: function () {
},
/**
* 页面相关事件处理函数--监听用户下拉动作
*/
onPullDownRefresh: function () {
},
/**
* 页面上拉触底事件的处理函数
*/
onReachBottom: function () {
},
/**
* 用户点击右上角分享
*/
onShareAppMessage: function () {
}
})
component 的 js 代码
Component({
/**
* 组件的属性列表
*/
properties: {
},
/**
* 组件的初始数据
*/
data: {
},
/**
* 组件的方法列表
*/
methods: {
}
})
本例中每个 tab 都是一个小程序中定义的 component , 只有最外层包裹的 myapp 是 page，因为page中只能嵌入component，component中也可以嵌入component。
代码解析
先看myapp，这是程序的主界面。它包含了两个tab：home 和 mine，分别对应页面下方的 主页 和 我的。
要引入自定义组件需要在 myapp.json文件中声明：
{
"usingComponents":{
"home": "./home/home",
"mine": "./mine/mine"
}
}
现在，就可以在 myapp.wxml 文件中愉快的引用了
<view class='container'>
<view class='content'>
<view wx:if='{{currentTab == 0}}'>
<home/>
</view>
<view wx:if='{{currentTab == 1}}'>
<mine/>
</view>
</view>
<!-- 下面的两个tab -->
<view class='bottom-tab'>
<view class='tab-item {{currentTab == 0 ? "active" : ""}}' data-current="0" bindtap='switchTab'>
<image src='{{currentTab == 0 ? "../../assets/home_active.png" : "../../assets/home.png"}}' class='item-img'></image>
<text class='item-text'>主页</text>
</view>
<view class='tab-item {{currentTab == 1 ? "active" : ""}}' data-current="1" bindtap='switchTab'>
<image src='{{currentTab == 1 ? "../../assets/mine_active.png" : "../../assets/mine.png"}}' class='item-img'></image>
<text class='item-text'>我的</text>
</view>
</view>
</view>
tab切换的原理是根据 wx:if 或者 hidden 来控制视图的显示和隐藏，页面的data中设置一个变量currentTab来记录当前点击的是哪个tab，每次点击的时候更新currentTab的值。
切换tab的方法：
switchTab(e) {
this.setData({ currentTab: e.currentTarget.dataset.current });
}
这里有几个需要注意的点：
- 这里判断相等用了
==而不是===，因为通过e.currentTarget.dataset.current取到的值是字符串类型的，也就是给data设置的值是字符串的0和1，如果用===就会判断出错。当然也可以强转成数字类型的，我比较懒~ - 控制组件显示隐藏可以用
wx:if也可以用hidden。两者是区别是如果用wx:if，每次切换tab的时候组件都会重新渲染，生命周期方法会重新调用执行。而用hidden则不会重新渲染，生命周期函数也不会重新调用。
具体用哪个看业务需求了，贴一段官方的描述：
image
再看主页home，它本身是一个component，又包含了两个component ：最热hot 和 最新new。
同样需要在home.json中注册这两个组件
{
"component": true,
"usingComponents": {
"hot": "hot/hot",
"new": "new/new"
}
}
注意home本身是一个component，所以需要注明"component": true
布局文件 home.wxml
<view class='container'>
<view class='tab-wrapper'>
<view id='tableft' class='tab-left {{currentTab === 0 ? "tab-active":""}}' bindtap='switchTab'>最热</view>
<view id='tabright' class='tab-right {{currentTab === 1 ? "tab-active" : ""}}' bindtap='switchTab'>最新</view>
</view>
<view class='content-wrapper' wx:if='{{currentTab === 0}}'><hot/></view>
<view class='content-wrapper' wx:if='{{currentTab === 1}}'><new/></view>
</view>
js文件 home.js
Component({
/**
* 组件的属性列表
*/
properties: {
},
/**
* 组件的初始数据
*/
data: {
currentTab: 0
},
/**
* 组件的方法列表
*/
methods: {
switchTab(e) {
console.log(e)
let tab = e.currentTarget.id
if (tab === 'tableft') {
this.setData({ currentTab: 0 })
} else if (tab === 'tabright') {
this.setData({ currentTab: 1 })
}
}
}
})
给两个tab的view设置了id属性值为tableft和tabright，设置了id后就可以用e.currentTarget.id获取到当前点击的是哪个元素了。
其他几个页面的代码都大同小异，主要是判断当前点击的是哪个tab，然后根据currentTab判断该显示或隐藏哪个组件。
源码地址：
https://github.com/cachecats/mini-multi-tab
作者正在写一个有趣的开源项目 coderiver，致力于打造全平台型全栈精品开源项目。
coderiver 中文名 河码，是一个为程序员和设计师提供项目协作的平台。无论你是前端、后端、移动端开发人员，或是设计师、产品经理，都可以在平台上发布项目，与志同道合的小伙伴一起协作完成项目。
coderiver 河码 类似程序员客栈，但主要目的是方便各细分领域人才之间技术交流，共同成长，多人协作完成项目。暂不涉及金钱交易。
计划做成包含 pc端（Vue、React）、移动H5（Vue、React）、ReactNative混合开发、Android原生、微信小程序、java后端的全平台型全栈项目，欢迎关注。
项目地址：https://github.com/cachecats/coderiver
您的鼓励是我前行最大的动力，欢迎点赞，欢迎送小星星✨ ~
