微信小程序全局配置之tabBar實(shí)戰(zhàn)案例
全局配置 - tabBar
1. 什么是 tabBar
tabBar 是移動(dòng)端應(yīng)用常見的頁面效果, 用于實(shí)現(xiàn)多頁面 的快速切換 。
小程序中通常將其分為:
- 底部 tabBar
- 頂部 tabBar

注意: tabBar中只能配置最少 2 個(gè)、最多 5 個(gè) tab 頁簽 當(dāng)渲染頂部 tabBar 時(shí),不顯示 icon,只顯示文本
2. tabBar 的 6 個(gè)組成部分

① backgroundColor:tabBar 的背景色
② selectedIconPath:選中時(shí)的圖片路徑
③ borderStyle:tabBar 上邊框的顏色
④ iconPath:未選中時(shí)的圖片路徑
⑤ selectedColor:tab 上的文字選中時(shí)的顏色
⑥ color:tab 上文字的默認(rèn)(未選中)顏色
3. tabBar 節(jié)點(diǎn)的配置項(xiàng)
| 屬性 | 類型 | 必填 | 默認(rèn)值 | 描述 |
| position | String | 否 | bottom | tabBar 的位置,僅支持 bottom/top |
| borderStyle | String | 否 | black | tabBar 上邊框的顏色,僅支持 black/white |
| color | HexColor | 否 | tab 上文字的默認(rèn)(未選中)顏色 | |
| selectedColor | HexColor | 否 | tab 上的文字選中時(shí)的顏色 | |
| backgroundColor | HexColor | 否 | tabBar 的背景色 | |
| list | Array | 是 | tab 頁簽的列表,
最少 2 個(gè)、最多 5 個(gè) tab |
4. 每個(gè) tab 項(xiàng)的配置選項(xiàng)
| 屬性 | 類型 | 必填 | 描述 |
| pagePath | String | 是 | 頁面路徑,頁面必須在 pages 中預(yù)先定義 |
| text | String | 是 | tab 上顯示的文字 |
| iconPath | String | 否 | 未選中時(shí)的圖標(biāo)路徑;當(dāng) postion 為 top 時(shí),不顯示 icon |
| selectedIconPath | String | 否 | 選中時(shí)的圖標(biāo)路徑;當(dāng) postion 為 top 時(shí),不顯示 icon |
全局配置 - 案例:配置 tabBar
1. 需求描述
根據(jù)素材中提供的小圖標(biāo)、 在小程序中配置如圖所示的 tabBar 效果:



素材: 





2. 實(shí)現(xiàn)步驟
① 拷貝圖標(biāo)資源
② 新建 3 個(gè)對(duì)應(yīng)的 tab 頁面
③ 配置 tabBar 選項(xiàng)
3. 步驟1 - 拷貝圖標(biāo)資源
① 把資料目錄中的 images 文件夾, 拷貝到小程序項(xiàng)目根目錄中
② 將需要用到的小圖標(biāo)分為 3 組,每組兩個(gè),其中:
圖片名稱中 包含 -active 的是選中之后 的圖標(biāo)
圖片名稱中 不包含 -active 的是 默認(rèn)圖標(biāo)
截圖如下:

4.步驟2 - 新建 3 個(gè)對(duì)應(yīng)的 tab 頁面
通過 app.json 文件的 pages 節(jié)點(diǎn),快速新建 3 個(gè)對(duì)應(yīng)的 tab 頁面,示例代碼如下:

其中,home 是首頁,message 是消息頁面,contact 是聯(lián)系我們頁面。
5. 步驟3 - 配置 tabBar 選項(xiàng)
① 打開 app.json 配置文件,和 pages、window 平級(jí),新增 tabBar 節(jié)點(diǎn)
② tabBar 節(jié)點(diǎn)中,新增 list 數(shù)組 ,這個(gè)數(shù)組中存放的,是每個(gè) tab 項(xiàng)的配置對(duì)象
③ 在 list 數(shù)組中, 新增每一個(gè) tab 項(xiàng)的配置對(duì)象 。對(duì)象中包含的屬性如下:
- pagePath 指定當(dāng)前 tab 對(duì)應(yīng)的頁面路徑 【 必填 】
- text 指定當(dāng)前 tab 上按鈕的文字【 必填 】
- iconPath 指定當(dāng)前 tab 未選中時(shí)候的圖片路徑【可選】
- selectedIconPath 指定當(dāng)前 tab 被選中后高亮的圖片路徑【可選】
6. 完整的配置代碼
{
"pages": [
"pages/home/home",
"pages/message/message",
"pages/contact/contact"
],
"window": {
"backgroundTextStyle": "light",
"navigationBarBackgroundColor": "#f12321",
"navigationBarTitleText": "測(cè)試",
"navigationBarTextStyle": "white"
},
"tabBar": {
"list": [
{
"pagePath": "pages/home/home",
"text": "首頁",
"iconPath": "/images/tabs/home.png",
"selectedIconPath": "/images/tabs/home-active.png"
},
{
"pagePath": "pages/message/message",
"text": "消息",
"iconPath": "/images/tabs/message.png",
"selectedIconPath": "/images/tabs/message-active.png"
},
{
"pagePath": "pages/contact/contact",
"text": "聯(lián)系我們",
"iconPath": "/images/tabs/contact.png",
"selectedIconPath": "/images/tabs/contact-active.png"
}
]
},
"style": "v2",
"sitemapLocation": "sitemap.json"
}總結(jié)
到此這篇關(guān)于微信小程序全局配置之tabBar的文章就介紹到這了,更多相關(guān)微信小程序全局配置tabBar內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
基于JavaScript 性能優(yōu)化技巧心得(分享)
下面小編就為大家分享一篇基于JavaScript 性能優(yōu)化技巧心得,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過來看看吧2017-12-12
JSON與String互轉(zhuǎn)的實(shí)現(xiàn)方法(Javascript)
下面小編就為大家?guī)硪黄狫SON與String互轉(zhuǎn)的實(shí)現(xiàn)方法(Javascript) 。小編覺得挺不錯(cuò)的,現(xiàn)在就分享給大家,也給大家做個(gè)參考。一起跟隨小編過來看看吧,祝大家游戲愉快哦2016-09-09
一文讓你徹底搞懂TypeScript(TS)和JavaScript(JS)區(qū)別與聯(lián)系
TS是JS的超集,是一個(gè)可選的、靜態(tài)的類型系統(tǒng),下面這篇文章主要介紹了關(guān)于TypeScript(TS)和JavaScript(JS)區(qū)別與聯(lián)系的相關(guān)資料,文中通過代碼介紹的非常詳細(xì),需要的朋友可以參考下2025-04-04
JavaScript Array對(duì)象擴(kuò)展indexOf()方法
JavaScript中Array對(duì)象沒有indexOf()方法,可通過下面的代碼擴(kuò)展,需要的朋友可以參考下2014-05-05
用window.onerror捕獲并上報(bào)Js錯(cuò)誤的方法
這篇文章主要介紹了用window.onerror捕獲并上報(bào)Js錯(cuò)誤的方法,需要的朋友可以參考下2016-01-01
淺析在javascript中創(chuàng)建對(duì)象的各種模式
下面小編就為大家?guī)硪黄獪\析在javascript中創(chuàng)建對(duì)象的各種模式。小編覺得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過來看看吧2016-05-05

