微信小程序自定義導航欄實例代碼

更新時間：2019年04月05日 10:44:52 作者：快狗打車前端團隊

這篇文章主要給大家介紹了關于微信小程序自定義導航欄的相關資料，文中通過示例代碼介紹的非常詳細，對大家學習或者使用微信小程序具有一定的參考學習價值，需要的朋友們下面來一起學習學習吧

背景

在做快狗打車小程序時，關于默認導航欄，我們遇到了以下的問題：

Android、IOS手機對于頁面title的展示不一致，安卓title的顯示不居中
頁面的title只支持純文本級別的樣式控制，不能夠做更豐富的title效果
左上角的事件無法監(jiān)聽、定制
路由導航單一，只能夠返回上一頁，深層級頁面的返回不夠友好

我們希望的是：在各個機型頁面上title一致性 & 個性化展示、取得左上角點擊事件控制權及深層級頁面的一鍵返回

實現(xiàn)

step1 自定義

第一步取得導航欄的控制權

小程序支持自定義導航欄，只需要在app.json文件中，window項中配置

"navigationStyle": "custom"

這樣微信就放開了導航欄的控制權，只保留右上角的膠囊。

頁面會從視窗的頂部開始渲染，如圖

接下來，我們要做的就是實現(xiàn)一個導航欄組件，把它放置在頁面原來的默認導航欄的位置，內容什么的完全由開發(fā)者自己定制。

step2 功能點

第二步梳理導航欄的功能點

導航欄高度（各個機型動態(tài)適配）
導航欄內容定制
- 所有機型title居中顯示（自己布局實現(xiàn)）
- 首頁導航欄左上角顯示個人中心、中部title使用個性圖標
- 嵌套頁面左上角顯示返回上一頁 + 回到首頁按鈕
- 非常規(guī)首頁左上角顯示回到首頁按鈕

導航欄高度包含兩個部分：工具欄和title欄，工具欄的高度一般是固定的20px，title欄的高度需要計算

導航欄內容的定制，需要識別當前頁面的性質，根據不同的頁面展示不同的內容，可以通過獲取當前的頁面路由棧來判定當前的頁面性質

step3 導航欄組件基本結構

目前快狗打車小程序的基本結構

// navBar.wxml
<cover-view class='place-holder'></cover-view>
<cover-view class='nav-bar'>
 <cover-view class='tool-bar' style='height: 20px'></cover-view>
 <cover-view class='title-bar'>
  <cover-view class='left-cell'>
   // scene0 常規(guī)首頁 個人中心按鈕
   // scene1 非常規(guī)首頁 回首頁按鈕
   // scene2 嵌套頁  返回上一頁按鈕 + 回首頁按鈕
  </cover-view>
  <cover-view class='center-cell'>
   // scene0 常規(guī)首頁 個性化title
   // scene1 其他頁 正常title
  </cover-view>
  <cover-view class='right-cell'>
   // 占位用的
  </cover-view>
 </cover-view>
</cover-view>

Tips：

組件內多了一個占位的place-holder塊，是因為某些頁面有類似滾動列表的需求，要保證導航欄始終在視窗的頂部的話，需要使用定位，定位之后脫離文檔流，在最初的時候需要占位塊保證后續(xù)的頁面內容不會被導航欄遮擋

使用cover-view布局是因為快狗的業(yè)務中有類似map的原生組件，使用view的話有被遮擋的風險

step4 高度計算

需要計算title-bar的高度

在默認導航欄 & 無底部tab欄的情況下，使用wx.getSystemInfoSync獲取手機信息，可以看到兩項信息:

screenHeight 屏幕高度，單位px
windowHeight 可使用窗口高度，單位px

這種情況下，二者的差值就是默認的導航欄的高度, 但是在設置了"navigationStyle": "custom"之后，二者的值是一樣的了，因此導航欄的高度我們需要使用統(tǒng)計的經驗值。

根據統(tǒng)計，得到如下的結果：

{
 'iPhone': 64,
 'iPhoneX': 88,
 'Android': 68,
 'samsung': 72
}

工具欄的高度可根據wx.getSystemInfoSync返回值中的statusBarHeight獲取。

至此，我們得到了導航欄的相關的高度值

// 導航欄總高度 & 占位塊高度
placeHoder = totalBar = {
 'iPhone': 64,
 'iPhoneX': 88,
 'Android': 68,
 'samsung': 72
}
// 時間、信號等工具欄的高度
toolBar = systermInfo.statusBarHeight
// 頁面title欄的高度
titleBar = totalBar - toolBar

step5 內容定制

在組件的生命周期函數attached中，我們可以獲取當前的頁面路由棧

let pages = getCurrentPages()
let current_page = pages[pages.length - 1].route 
const NORMAL_ENTRY = '常規(guī)的入口頁路徑'

// scene 0 常規(guī)入口頁 個性化title、個人中心
pages.length === 1 && current_page === NORMAL_ENTRY
// scene 1 非常規(guī)入口頁 回首頁
pages.length === 1 && current_page !== NORMAL_ENTRY
// scene 2 嵌套頁面 返回 + 回首頁
pages.length > 1

根據不同的條件，展示不同的內容

最終效果

scene 0 常規(guī)首頁