微信小程序API tabBar

2022-05-09 17:06 更新

wx.showTabBarRedDot(Object object)

基礎(chǔ)庫 1.9.0 開始支持,低版本需做兼容處理。

顯示 tabBar 某一項(xiàng)的右上角的紅點(diǎn)

參數(shù)

Object object

屬性 類型 默認(rèn)值 必填 說明
index number tabBar 的哪一項(xiàng),從左邊算起
success function 接口調(diào)用成功的回調(diào)函數(shù)
fail function 接口調(diào)用失敗的回調(diào)函數(shù)
complete function 接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會執(zhí)行)


wx.showTabBar(Object object)

基礎(chǔ)庫 1.9.0 開始支持,低版本需做兼容處理

顯示 tabBar

參數(shù)

Object object

屬性 類型 默認(rèn)值 必填 說明
animation boolean false 是否需要動畫效果
success function 接口調(diào)用成功的回調(diào)函數(shù)
fail function 接口調(diào)用失敗的回調(diào)函數(shù)
complete function 接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會執(zhí)行)




wx.setTabBarStyle(Object object)

基礎(chǔ)庫 1.9.0 開始支持,低版本需做兼容處理。

動態(tài)設(shè)置 tabBar 的整體樣式

參數(shù)

Object object

屬性 類型 默認(rèn)值 必填 說明
color string tab 上的文字默認(rèn)顏色,HexColor
selectedColor string tab 上的文字選中時的顏色,HexColor
backgroundColor string tab 的背景色,HexColor
borderStyle string tabBar上邊框的顏色, 僅支持 black/white
success function 接口調(diào)用成功的回調(diào)函數(shù)
fail function 接口調(diào)用失敗的回調(diào)函數(shù)
complete function 接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會執(zhí)行)

示例代碼

wx.setTabBarStyle({
  color: '#FF0000',
  selectedColor: '#00FF00',
  backgroundColor: '#0000FF',
  borderStyle: 'white'
})




wx.setTabBarItem(Object object)

基礎(chǔ)庫 1.9.0 開始支持,低版本需做兼容處理

動態(tài)設(shè)置 tabBar 某一項(xiàng)的內(nèi)容,2.7.0 起圖片支持臨時文件和網(wǎng)絡(luò)文件。

參數(shù)

Object object

屬性 類型 默認(rèn)值 必填 說明
index number tabBar 的哪一項(xiàng),從左邊算起
text string tab 上的按鈕文字
iconPath string 圖片路徑,icon 大小限制為 40kb,建議尺寸為 81px * 81px,當(dāng) postion 為 top 時,此參數(shù)無效
selectedIconPath string 選中時的圖片路徑,icon 大小限制為 40kb,建議尺寸為 81px * 81px ,當(dāng) postion 為 top 時,此參數(shù)無效
success function 接口調(diào)用成功的回調(diào)函數(shù)
fail function 接口調(diào)用失敗的回調(diào)函數(shù)
complete function 接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會執(zhí)行)

示例代碼

wx.setTabBarItem({
  index: 0,
  text: 'text',
  iconPath: '/path/to/iconPath',
  selectedIconPath: '/path/to/selectedIconPath'
})




wx.setTabBarBadge(Object object)

基礎(chǔ)庫 1.9.0 開始支持,低版本需做兼容處理

為 tabBar 某一項(xiàng)的右上角添加文本

參數(shù)

Object object

屬性 類型 默認(rèn)值 必填 說明
index number tabBar 的哪一項(xiàng),從左邊算起
text string 顯示的文本,超過 4 個字符則顯示成 ...
success function 接口調(diào)用成功的回調(diào)函數(shù)
fail function 接口調(diào)用失敗的回調(diào)函數(shù)
complete function 接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會執(zhí)行)

示例代碼

wx.setTabBarBadge({
  index: 0,
  text: '1'
})




wx.removeTabBarBadge(Object object)

基礎(chǔ)庫 1.9.0 開始支持,低版本需做兼容處理。

移除 tabBar 某一項(xiàng)右上角的文本

參數(shù)

Object object

屬性 類型 默認(rèn)值 必填 說明
index number tabBar 的哪一項(xiàng),從左邊算起
success function 接口調(diào)用成功的回調(diào)函數(shù)
fail function 接口調(diào)用失敗的回調(diào)函數(shù)
complete function 接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會執(zhí)行)




wx.hideTabBarRedDot(Object object)

基礎(chǔ)庫 1.9.0 開始支持,低版本需做兼容處理

隱藏 tabBar 某一項(xiàng)的右上角的紅點(diǎn)

參數(shù)

Object object

屬性 類型 默認(rèn)值 必填 說明
index number tabBar 的哪一項(xiàng),從左邊算起
success function 接口調(diào)用成功的回調(diào)函數(shù)
fail function 接口調(diào)用失敗的回調(diào)函數(shù)
complete function 接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會執(zhí)行)




wx.hideTabBar(Object object)

基礎(chǔ)庫 1.9.0 開始支持,低版本需做兼容處理

隱藏 tabBar

參數(shù)

Object object

屬性類型默認(rèn)值必填說明
animationbooleanfalse是否需要動畫效果
successfunction接口調(diào)用成功的回調(diào)函數(shù)
failfunction接口調(diào)用失敗的回調(diào)函數(shù)
completefunction接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會執(zhí)行)


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號