# 自定義 tabBar

基礎(chǔ)庫(kù) 2.5.0 開(kāi)始支持，低版本需做兼容處理。

自定義 tabBar 可以讓開(kāi)發(fā)者更加靈活地設(shè)置 tabBar 樣式，以滿(mǎn)足更多個(gè)性化的場(chǎng)景。

在自定義 tabBar 模式下

為了保證低版本兼容以及區(qū)分哪些頁(yè)面是 tab 頁(yè)，tabBar 的相關(guān)配置項(xiàng)需完整聲明，但這些字段不會(huì)作用于自定義 tabBar 的渲染。
此時(shí)需要開(kāi)發(fā)者提供一個(gè)自定義組件來(lái)渲染 tabBar，所有 tabBar 的樣式都由該自定義組件渲染。推薦用 fixed 在底部的 cover-view + cover-image 組件渲染樣式，以保證 tabBar 層級(jí)相對(duì)較高。
與 tabBar 樣式相關(guān)的接口，如 wx.setTabBarItem 等將失效。
每個(gè) tab 頁(yè)下的自定義 tabBar 組件實(shí)例是不同的，可通過(guò)自定義組件下的 getTabBar 接口，獲取當(dāng)前頁(yè)面的自定義 tabBar 組件實(shí)例。

注意：如需實(shí)現(xiàn) tab 選中態(tài)，要在當(dāng)前頁(yè)面下，通過(guò) getTabBar 接口獲取組件實(shí)例，并調(diào)用 setData 更新選中態(tài)?？蓞⒖嫉撞康拇a示例。

# 使用流程

# 1. 配置信息

在 app.json 中的 tabBar 項(xiàng)指定 custom 字段，同時(shí)其余 tabBar 相關(guān)配置也補(bǔ)充完整。
所有 tab 頁(yè)的 json 里需聲明 usingComponents 項(xiàng)，也可以在 app.json 全局開(kāi)啟。

示例：

{
  "tabBar": {
    "custom": true,
    "color": "#000000",
    "selectedColor": "#000000",
    "backgroundColor": "#000000",
    "list": [{
      "pagePath": "page/component/index",
      "text": "組件"
    }, {
      "pagePath": "page/API/index",
      "text": "接口"
    }]
  },
  "usingComponents": {}
}

# 2. 添加 tabBar 代碼文件

在代碼根目錄下添加入口文件:

custom-tab-bar/index.js
custom-tab-bar/index.json
custom-tab-bar/index.wxml
custom-tab-bar/index.wxss

# 3. 編寫(xiě) tabBar 代碼

用自定義組件的方式編寫(xiě)即可，該自定義組件完全接管 tabBar 的渲染。另外，自定義組件新增 getTabBar 接口，可獲取當(dāng)前頁(yè)面下的自定義 tabBar 組件實(shí)例。

# 示例代碼

在開(kāi)發(fā)者工具中預(yù)覽效果

# skyline 模式

使用 skyline 渲染模式的時(shí)候，需要進(jìn)行如下適配：

# 1. tabBar 組件樣式兼容

tabBar 根組件需要添加 pointer-events: auto
tabBar 根組件定位需為 position: absolute

<view class="tab-bar">
  <!-- tabbar item-->
</view>

.tab-bar {
  pointer-events: auto;
  position: absolute;
}

# 2. getTabBar 回調(diào)函數(shù)

skyline 模式下，頁(yè)面/組件上的 getTabBar 接口為異步回調(diào)的方式獲取 tabBar 實(shí)例

Page({
  getInstance() {
    if (typeof this.getTabBar === 'function' ) {
      this.getTabBar((tabBar) => {
        tabBar.setData({
          selected: 0
        })
      })
    }
  }
})

# skyline 示例代碼