微信小程序自定義tab,多層tab嵌套實現(xiàn)

小程序最近是越來越火了……
做小程序有一段時間了,總結(jié)一下項目中遇到的問題及解決辦法吧。

項目中有個多 tab 嵌套的需求,進入程序主界面下面有兩個 tab,進入A模塊后,A模塊最底下又有多個tab,每個tab上又嵌了2-4個不等的tab。。。

這種變態(tài)需求只能自定義tab了。

其實如果項目不是很復(fù)雜,沒有多tab嵌套的需求,完全可以用小程序官方的 tabBar,方便快捷。
官方 tabBar 地址:https://developers.weixin.qq.com/miniprogram/dev/framework/config.html


一、Demo結(jié)構(gòu)

先看效果圖吧

image
image

結(jié)構(gòu)是這樣的:程序主界面包含兩個 tab:主頁和我的,主頁又包含兩個tab:最熱和最新;我的也包含兩個tab:電影和音樂。
關(guān)系圖如下:

項目
    主頁
        最熱
        最新
    我的
        電影
        音樂

二、開始擼代碼

再看代碼結(jié)構(gòu)

image

兩種頁面結(jié)構(gòu)

小程序的頁面分為兩種:pagecomponents。
page就是普通的頁面, components是小程序為實現(xiàn)模塊化而提供的自定義組件。

相同點:
都由四個文件:.js、.json、.wxml.wxss、構(gòu)成,.wxml.wxss寫法完全相同。

不同點:

  1. components要在json文件中注明:"component": true
{
  "component": true,
  "usingComponents": {
    "movie": "movie/movie",
    "music": "music/music"
  }
}
  1. js文件的結(jié)構(gòu)和生命周期函數(shù)不同
    下面是自動生成的pagecomponents代碼,可以感受下

page 的 js 代碼

Page({

  /**
   * 頁面的初始數(shù)據(jù)
   */
  data: {
  
  },

  /**
   * 生命周期函數(shù)--監(jiān)聽頁面加載
   */
  onLoad: function (options) {
  
  },

  /**
   * 生命周期函數(shù)--監(jiān)聽頁面初次渲染完成
   */
  onReady: function () {
  
  },

  /**
   * 生命周期函數(shù)--監(jiān)聽頁面顯示
   */
  onShow: function () {
  
  },

  /**
   * 生命周期函數(shù)--監(jiān)聽頁面隱藏
   */
  onHide: function () {
  
  },

  /**
   * 生命周期函數(shù)--監(jiān)聽頁面卸載
   */
  onUnload: function () {
  
  },

  /**
   * 頁面相關(guān)事件處理函數(shù)--監(jiān)聽用戶下拉動作
   */
  onPullDownRefresh: function () {
  
  },

  /**
   * 頁面上拉觸底事件的處理函數(shù)
   */
  onReachBottom: function () {
  
  },

  /**
   * 用戶點擊右上角分享
   */
  onShareAppMessage: function () {
  
  }
})

component 的 js 代碼

Component({
  /**
   * 組件的屬性列表
   */
  properties: {

  },

  /**
   * 組件的初始數(shù)據(jù)
   */
  data: {

  },

  /**
   * 組件的方法列表
   */
  methods: {

  }
})

本例中每個 tab 都是一個小程序中定義的 component , 只有最外層包裹的 myapppage,因為page中只能嵌入componentcomponent中也可以嵌入component。

代碼解析

先看myapp,這是程序的主界面。它包含了兩個tabhomemine,分別對應(yīng)頁面下方的 主頁我的。
要引入自定義組件需要在 myapp.json文件中聲明:

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

現(xiàn)在,就可以在 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切換的原理是根據(jù) wx:if 或者 hidden 來控制視圖的顯示和隱藏,頁面的data中設(shè)置一個變量currentTab來記錄當(dāng)前點擊的是哪個tab,每次點擊的時候更新currentTab的值。

切換tab的方法:

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

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

  1. 這里判斷相等用了 == 而不是 === ,因為通過 e.currentTarget.dataset.current取到的值是字符串類型的,也就是給 data 設(shè)置的值是字符串的01,如果用 === 就會判斷出錯。當(dāng)然也可以強轉(zhuǎn)成數(shù)字類型的,我比較懶~
  2. 控制組件顯示隱藏可以用 wx:if 也可以用 hidden。兩者是區(qū)別是如果用 wx:if ,每次切換tab的時候組件都會重新渲染,生命周期方法會重新調(diào)用執(zhí)行。而用 hidden則不會重新渲染,生命周期函數(shù)也不會重新調(diào)用。
    具體用哪個看業(yè)務(wù)需求了,貼一段官方的描述:
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: {

  },

  /**
   * 組件的初始數(shù)據(jù)
   */
  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設(shè)置了id屬性值為tablefttabright,設(shè)置了id后就可以用e.currentTarget.id獲取到當(dāng)前點擊的是哪個元素了。

其他幾個頁面的代碼都大同小異,主要是判斷當(dāng)前點擊的是哪個tab,然后根據(jù)currentTab判斷該顯示或隱藏哪個組件。

源碼地址:
https://github.com/cachecats/mini-multi-tab


作者正在寫一個有趣的開源項目 coderiver,致力于打造全平臺型全棧精品開源項目。

coderiver 中文名 河碼,是一個為程序員和設(shè)計師提供項目協(xié)作的平臺。無論你是前端、后端、移動端開發(fā)人員,或是設(shè)計師、產(chǎn)品經(jīng)理,都可以在平臺上發(fā)布項目,與志同道合的小伙伴一起協(xié)作完成項目。

coderiver 河碼 類似程序員客棧,但主要目的是方便各細(xì)分領(lǐng)域人才之間技術(shù)交流,共同成長,多人協(xié)作完成項目。暫不涉及金錢交易。

計劃做成包含 pc端(Vue、React)、移動H5(Vue、React)、ReactNative混合開發(fā)、Android原生、微信小程序、java后端的全平臺型全棧項目,歡迎關(guān)注。

項目地址:https://github.com/cachecats/coderiver

您的鼓勵是我前行最大的動力,歡迎點贊,歡迎送小星星? ~

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,563評論 6 544
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 99,694評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事?!?“怎么了?”我有些...
    開封第一講書人閱讀 178,672評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經(jīng)常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,965評論 1 318
  • 正文 為了忘掉前任,我火速辦了婚禮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當(dāng)我...
    茶點故事閱讀 72,690評論 6 413
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 56,019評論 1 329
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 44,013評論 3 449
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 43,188評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 49,718評論 1 336
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 41,438評論 3 360
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,667評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,149評論 5 365
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 44,845評論 3 351
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,252評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,590評論 1 295
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,384評論 3 400
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 48,635評論 2 380

推薦閱讀更多精彩內(nèi)容

  • 示例執(zhí)行 我使用ambari安裝的hadoop環(huán)境,jar包在/usr/lib/hadoop-yarn中。 執(zhí)行命...
    fengjixcuhui閱讀 675評論 0 0
  • 竟然三月一號了,要說三月的計劃嘛,那就把該做的做好,還沒排上號的順帶插空也做了,恰到好處就好。 我無意間一回頭,發(fā)...
    向日葵21閱讀 175評論 0 0
  • 在我的身邊總會有這樣的一些人,他們總是會時時刻刻宣揚著自己的優(yōu)越感,當(dāng)你說話的時候,他們就會反駁你,然后把你的...
    L落幕閱讀 387評論 0 2