mpvue中小程序自定義導航組件開發指南

這篇筆記主要記錄一下基於mpvue的小程序中實現自定義導航的思路及應用。分享出來拋磚引玉，若有謬誤或優化空間，歡迎交流。

小程序的配置項navigationStyle設置爲custom以後，導航欄只保留右上角膠囊按鈕，顏色、標題文字內容都可以自定義，能夠此實現導航欄的個性化需求，實際應用如沉浸式視頻播放頁等。

小程序7.0.0以後的版本開始支持自定義單個頁面的導航欄，將頁面的navigationStyle設置爲custom便可。mpvue的配置方式以下：

因爲不一樣操做系統、不一樣機型的導航欄高度是不一樣的，因此自定義導航欄核心要解決的問題是不一樣機型中導航欄高度的兼容問題。

如上圖所示，導航欄一共由兩部分組成：狀態欄和標題欄。狀態欄就是用來展現時間、網絡狀態的那一欄，全面屏（劉海屏幕）的機型中狀態欄會比其餘屏幕高不少：ios系統帶劉海屏的都是44，其餘都爲20,包括pad。 而安卓機的數值則更多。咱們能夠經過微信的apiwx.getSystemInfo獲取狀態欄的高度（statusBarHeight）。而標題欄高度不能經過小程序api獲取到，經過同級多個機型的測試數據，咱們基本能夠按照ios中44px安卓中48px來算。 這樣一來就好辦了，經過statusBarHeight獲取到狀態欄高度後，再判斷當前的系統加上對應的標題欄後，就能夠獲取到正確的導航欄高度了。

template中的html代：（由於小程序中的video組件有着最高的層級，是不會被普通html標籤覆蓋的，因此導航欄組件中所有采用了<cover-view>標籤。）：

<template>
    <div class="comp-navbar">
        <!-- 佔位欄 -->
        <cover-view class="placeholder-bar" :style="{height: navBarHeight + 'px'}"> </cover-view>
        <!-- 導航欄主體 -->
        <cover-view class="navbar" :style="{height: navBarHeight + 'px',backgroundColor:navBackgroundColor}">
            <!-- 狀態欄 -->
            <cover-view class="nav-statusbar" :style="{height: statusBarHeight + 'px'}"></cover-view>
            <!-- 標題欄 -->
            <cover-view class="nav-titlebar" :style="{height: titleBarHeight + 'px' }">
                <!-- home及後退鍵 -->
                <cover-view class="bar-options">
                    <cover-view v-if="backVisible" class="opt opt-back" @click="backClick()">
                    <cover-image class="back-image" src="/static/images/back.png"></cover-image>
                    </cover-view>
                    <cover-view class="line" v-if="backVisible && homePath"></cover-view>
                    <cover-view v-if="homePath" class="opt opt-home" @click="homeClick()">
                    <cover-image class="home-image" src="/static/images/home.png"></cover-image>
                    </cover-view>
                </cover-view>
                <!-- 標題 -->
                <cover-view class="bar-title" :style="[{color:titleColor}]">{{title}}</cover-view>
            </cover-view>
        </cover-view>
    </div>
</template>

複製代碼

js代碼：

beforeMount() {
        const self = this;
        wx.getSystemInfo({
            success(system) {
                console.log(`system:`, system);
                self.statusBarHeight = system.statusBarHeight;
                self.platform = system.platform;

                let platformReg = /ios/i;
                if (platformReg.test(system.platform)) {
                    self.titleBarHeight = 44;
                } else {
                    self.titleBarHeight = 48;
                }

                self.navBarHeight = self.statusBarHeight + self.titleBarHeight;
            }
        });
    },
複製代碼

自定義導航欄的可自定義內容：標題文字、文字顏色、標題欄背景色、回退按鈕是否顯示、home按鈕的地址。示例代碼以下：

<navigation-bar :title="videoTitle" :navBackgroundColor="'pink'" :titleColor="'green'" :back-visible="true" :home-path="'/pages/index/main'"></navigation-bar>
複製代碼

最後奉上github地址，歡迎檢閱代碼，歡迎star。