小程式最近是越來越火了……
做小程式有一段時間了,總結一下專案中遇到的問題及解決辦法吧。
專案中有個多 tab 巢狀的需求,進入程式主介面下面有兩個 tab,進入A模組後,A模組最底下又有多個tab,每個tab上又嵌了2-4個不等的tab。。。
這種變態需求只能自定義tab了。
其實如果專案不是很複雜,沒有多tab巢狀的需求,完全可以用小程式官方的 tabBar,方便快捷。
官方 tabBar 地址:
developers.weixin.qq.com/miniprogram…
一、Demo結構
先看效果圖吧
結構是這樣的:程式主介面包含兩個 tab:主頁和我的,主頁又包含兩個tab:最熱和最新;我的也包含兩個tab:電影和音樂。
關係圖如下:
專案
主頁
最熱
最新
我的
電影
音樂
複製程式碼
二、開始擼程式碼
再看程式碼結構
兩種頁面結構
小程式的頁面分為兩種: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
則不會重新渲染,生命週期函式也不會重新呼叫。
具體用哪個看業務需求了,貼一段官方的描述:
再看主頁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
判斷該顯示或隱藏哪個元件。
原始碼地址:
github.com/cachecats/m…