微信小程式自定義tab,多層tab巢狀實現

solocoder發表於2019-03-04

小程式最近是越來越火了……
做小程式有一段時間了,總結一下專案中遇到的問題及解決辦法吧。

專案中有個多 tab 巢狀的需求,進入程式主介面下面有兩個 tab,進入A模組後,A模組最底下又有多個tab,每個tab上又嵌了2-4個不等的tab。。。

這種變態需求只能自定義tab了。

其實如果專案不是很複雜,沒有多tab巢狀的需求,完全可以用小程式官方的 tabBar,方便快捷。
官方 tabBar 地址:
developers.weixin.qq.com/miniprogram…


一、Demo結構

先看效果圖吧

微信小程式自定義tab,多層tab巢狀實現
微信小程式自定義tab,多層tab巢狀實現

結構是這樣的:程式主介面包含兩個 tab:主頁和我的,主頁又包含兩個tab:最熱和最新;我的也包含兩個tab:電影和音樂。
關係圖如下:

專案
    主頁
        最熱
        最新
    我的
        電影
        音樂
複製程式碼

二、開始擼程式碼

再看程式碼結構

微信小程式自定義tab,多層tab巢狀實現

兩種頁面結構

小程式的頁面分為兩種: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 檔案中愉快的引用了

<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 });
}
複製程式碼

這裡有幾個需要注意的點:

  1. 這裡判斷相等用了 == 而不是 === ,因為通過 e.currentTarget.dataset.current取到的值是字串型別的,也就是給 data 設定的值是字串的01,如果用 === 就會判斷出錯。當然也可以強轉成數字型別的,我比較懶~
  2. 控制元件顯示隱藏可以用 wx:if 也可以用 hidden。兩者是區別是如果用 wx:if ,每次切換tab的時候元件都會重新渲染,生命週期方法會重新呼叫執行。而用 hidden則不會重新渲染,生命週期函式也不會重新呼叫。
    具體用哪個看業務需求了,貼一段官方的描述:
微信小程式自定義tab,多層tab巢狀實現

再看主頁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 })
      }
    }
  }
})
複製程式碼

給兩個tabview設定了id屬性值為tablefttabright,設定了id後就可以用e.currentTarget.id獲取到當前點選的是哪個元素了。

其他幾個頁面的程式碼都大同小異,主要是判斷當前點選的是哪個tab,然後根據currentTab判斷該顯示或隱藏哪個元件。

原始碼地址:
github.com/cachecats/m…

相關文章