近來微信小程序的討論熱度持續攀升,但搜尋關鍵字跑出來的內容多半還是官方文件的轉述。本文直接從實作切入,示範如何在小程序中做出一個左右結構的 Tab 選項卡——左側是垂直的標籤列表,右側是對應的內容區。
微信內部已封裝了相當多元件,但 Tab 選項卡並不在其中,因此這個效果需要自己實作。思路如下:
1、點擊導覽時需要兩個變數,一個儲存當前被點擊項的樣式類,一個儲存其他導覽項的預設樣式類。
2、選項卡內容列表同樣需要兩個變數,一個儲存當前要顯示的區塊,一個儲存其他隱藏的預設區塊。
3、使用三元運算取得點擊的導覽索引,依索引判斷是否加上當前類。這裡我把點擊事件綁在父級導覽列上,透過 target 物件取得觸發事件的子元素屬性。
請參考下圖效果:

demo.wxml
<view class="tab">
<view class="tab-left" bindtap="tabFun">
<view class="{{tabArr.curHdIndex=='0'? 'active' : ''}}" id="tab-hd01" data-id="0">tab-hd01</view>
<view class="{{tabArr.curHdIndex=='1'? 'active' : ''}}" id="tab-hd02" data-id="1">tab-hd02</view>
<view class="{{tabArr.curHdIndex=='2'? 'active' : ''}}" id="tab-hd03" data-id="2">tab-hd03</view>
<view class="{{tabArr.curHdIndex=='3'? 'active' : ''}}" id="tab-hd04" data-id="3">tab-hd04</view>
</view>
<view class="tab-right">
<view class="right-item {{tabArr.curBdIndex=='0'? 'active' : ''}}">tab-bd01</view>
<view class="right-item {{tabArr.curBdIndex=='1'? 'active' : ''}}">tab-bd02</view>
<view class="right-item {{tabArr.curBdIndex=='2'? 'active' : ''}}">tab-bd03</view>
<view class="right-item {{tabArr.curBdIndex=='3'? 'active' : ''}}">tab-bd04</view>
</view>
</view>
這裡有個設計值得留意:左側用 curHdIndex、右側用 curBdIndex 兩個獨立變數控制,而非共用一個。這樣做的好處是未來若需要「標籤與內容不同步」的特殊情境(例如載入中狀態),不必推翻整個結構。
demo.js
Page({
data: {
tabArr: {
curHdIndex: 0,
curBdIndex: 0
},
},
tabFun: function(e){
// 取得觸發事件組件的 dataset 屬性
var _datasetId = e.target.dataset.id;
console.log("----" + _datasetId + "----");
var _obj = {};
_obj.curHdIndex = _datasetId;
_obj.curBdIndex = _datasetId;
this.setData({ tabArr: _obj });
},
onLoad: function(options) {
alert("------");
}
});
關鍵是 e.target.dataset.id:因為監聽器掛在父層 .tab-left 上,必須靠 target 才能分辨使用者實際點了哪一個子項。這正是事件委派的標準做法——不必為每個標籤各綁一次事件,日後動態新增標籤也免改程式碼。
另一個重點是 setData 只能更新 data 中已宣告的欄位。這裡傳入的是 tabArr 的整體替換,屬於合法用法;若想只改其中一個屬性,需寫成 'tabArr.curHdIndex': _datasetId 這種路徑式寫法。
demo.wxss
.tab{
display: flex;
flex-direction: row;
}
.tab-left{
width: 200rpx;
line-height: 160%;
border-right: solid 1px gray;
}
.tab-left view{
border-bottom: solid 1px red;
}
.tab-left .active{
color: #f00;
}
.tab-right{
line-height: 160%;
}
.tab-right .right-item{
padding-left: 15rpx;
display: none;
}
.tab-right .right-item.active{
display: block;
}
右側內容的顯示與隱藏完全由 class 決定:預設 display:none,加上 active 後才 display:block。這種「用 class 控制狀態、由資料決定 class」的模式,是前端框架中相當通用的思路。
最終效果

可以再加強的地方
以上僅為個人實作方案,若有更好的做法歡迎提出。這裡補充三點實務上的建議。
第一,若標籤數量不固定,應改用 wx:for 搭配一個 tab 清單陣列來渲染,而非把四組標籤寫死。這樣新增分類只需改資料,不必動樣板。
第二,tabFun 中取到的 dataset.id 是字串,而 data 初始值 0 是數字。雖然在 == 比較下湊巧能運作,但嚴謹起見應統一型別,例如用 parseInt(_datasetId, 10) 轉為數字。
第三,切換時若右側內容較長,建議加上滾動位置重置,避免切到短內容時仍停在下方。
本文已整理進《JavaScript 微信開發技巧匯總》,歡迎延伸閱讀。另推薦關注度較高的《微信小程序開發教程》。