小程序最近是越來越火了……
做小程序有一段時間了,總結(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)
先看效果圖吧
結(jié)構(gòu)是這樣的:程序主界面包含兩個 tab:主頁和我的,主頁又包含兩個tab:最熱和最新;我的也包含兩個tab:電影和音樂。
關(guān)系圖如下:
項目
主頁
最熱
最新
我的
電影
音樂
二、開始擼代碼
再看代碼結(jié)構(gòu)
兩種頁面結(jié)構(gòu)
小程序的頁面分為兩種:page
和 components
。
page
就是普通的頁面, components
是小程序為實現(xiàn)模塊化而提供的自定義組件。
相同點:
都由四個文件:.js
、.json
、.wxml
、.wxss
、構(gòu)成,.wxml
、.wxss
寫法完全相同。
不同點:
-
components
要在json
文件中注明:"component": true
{
"component": true,
"usingComponents": {
"movie": "movie/movie",
"music": "music/music"
}
}
-
js
文件的結(jié)構(gòu)和生命周期函數(shù)不同
下面是自動生成的page
和components
代碼,可以感受下
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
, 只有最外層包裹的 myapp
是 page
,因為page
中只能嵌入component
,component
中也可以嵌入component
。
代碼解析
先看myapp
,這是程序的主界面。它包含了兩個tab
:home
和 mine
,分別對應(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 });
}
這里有幾個需要注意的點:
- 這里判斷相等用了
==
而不是===
,因為通過e.currentTarget.dataset.current
取到的值是字符串類型的,也就是給data
設(shè)置的值是字符串的0
和1
,如果用===
就會判斷出錯。當(dāng)然也可以強轉(zhuǎn)成數(shù)字類型的,我比較懶~ - 控制組件顯示隱藏可以用
wx:if
也可以用hidden
。兩者是區(qū)別是如果用wx:if
,每次切換tab的時候組件都會重新渲染,生命周期方法會重新調(diào)用執(zhí)行。而用hidden
則不會重新渲染,生命周期函數(shù)也不會重新調(diào)用。
具體用哪個看業(yè)務(wù)需求了,貼一段官方的描述:
再看主頁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 })
}
}
}
})
給兩個tab
的view
設(shè)置了id
屬性值為tableft
和tabright
,設(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
您的鼓勵是我前行最大的動力,歡迎點贊,歡迎送小星星? ~