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

2020-03-21 16:00:18

字體：大中小

來源：轉載

供稿：網友

背景

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

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

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

實現

step1 自定義

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

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

"navigationStyle": "custom"

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

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

微信小程序,導航欄,代碼

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

step2 功能點

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

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

導航欄高度包含兩個部分：工具欄和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 常規首頁 個人中心按鈕   // scene1 非常規首頁 回首頁按鈕   // scene2 嵌套頁  返回上一頁按鈕 + 回首頁按鈕  </cover-view>  <cover-view class='center-cell'>   // scene0 常規首頁 個性化title   // scene1 其他頁 正常title  </cover-view>  <cover-view class='right-cell'>   // 占位用的  </cover-view> </cover-view></cover-view>

Tips：

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

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

step4 高度計算

需要計算title-bar的高度

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

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

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

根據統計，得到如下的結果：

{ '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 = '常規的入口頁路徑'// scene 0 常規入口頁 個性化title、個人中心pages.length === 1 && current_page === NORMAL_ENTRY// scene 1 非常規入口頁 回首頁pages.length === 1 && current_page !== NORMAL_ENTRY// scene 2 嵌套頁面 返回 + 回首頁pages.length > 1

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

最終效果

scene 0 常規首頁

微信小程序,導航欄,代碼