微信小程序自定义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

两种页面结构

小程序的页面分为两种:pagecomponents
page就是普通的页面, components是小程序为实现模块化而提供的自定义组件。

相同点:
都由四个文件:.js.json.wxml.wxss、构成,.wxml.wxss写法完全相同。

不同点:

  1. components要在json文件中注明:"component": true
{
  "component": true,
  "usingComponents": {
    "movie": "movie/movie",
    "music": "music/music"
  }
}
  1. js文件的结构和生命周期函数不同
    下面是自动生成的pagecomponents代码,可以感受下

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 , 只有最外层包裹的 myapppage,因为page中只能嵌入componentcomponent中也可以嵌入component

代码解析

先看myapp,这是程序的主界面。它包含了两个tabhomemine,分别对应页面下方的 主页我的
要引入自定义组件需要在 myapp.json文件中声明:

{
  "usingComponents":{
    "home": "./home/home",
    "mine": "./mine/mine"
  }
}

现在,就可以在 myapp.wxml 文件中愉快的引用了


  
    
      
    
    
      
    
  

  
  
    
      
      主页
    

    
      
      我的
    
  

tab切换的原理是根据 wx:if 或者 hidden 来控制视图的显示和隐藏,页面的data中设置一个变量currentTab来记录当前点击的是哪个tab,每次点击的时候更新currentTab的值。

切换tab的方法:

switchTab(e) {
    this.setData({ currentTab: e.currentTarget.dataset.current });
}

这里有几个需要注意的点:

  1. 这里判断相等用了 == 而不是 === ,因为通过 e.currentTarget.dataset.current取到的值是字符串类型的,也就是给 data 设置的值是字符串的01,如果用 === 就会判断出错。当然也可以强转成数字类型的,我比较懒~
  2. 控制组件显示隐藏可以用 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


  
    最热
    最新
  

  
  

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 })
      }
    }
  }
})

给两个tabview设置了id属性值为tablefttabright,设置了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

您的鼓励是我前行最大的动力,欢迎点赞,欢迎送小星星✨ ~

你可能感兴趣的:(微信小程序自定义tab,多层tab嵌套实现)