uniapp微信小程序自定義導航欄的全過程

前言

相信很多小夥伴在使用uniapp進行多端開發的時候呢,在面對一些奇葩的業務需求的時候,uniapp給我們提供的默認導航欄已經不能滿足我們的業務需求瞭,這個時候就需要我們自己自定義導航欄使用啦。

當然uniapp也給我們提供瞭很多的自定義導航欄的插件供大傢使用,今天也給大傢分享一個我自己寫的導航欄啦,希望大傢多多指點

首先我們在自定義導航欄的時候,我們需要知道頭部的導航欄有哪幾部分組成,那麼我們以微信小程序為例

可以看到在微信小程序中,我們的頭部導航欄其實受到右上角膠囊的限制比較大,這個時候我們自定義的導航欄,需要做到標題於膠囊水平對齊,那其實這個時候整個頭部其實主要又:狀態欄的高度+標題欄的高度組成。

狀態欄的高度我們可以通過uni.getSystemInfoSync().statusBarHeight來獲取。

那麼標題欄的高度我們怎麼獲取呢?

其實要想定義標題欄的高度,我們需要知道這個膠囊的位置,在小程序中我們可以使用wx.getMenuButtonBoundingClientRect()獲取關於膠囊的信息

獲取到的膠囊的top,left,right分別對應膠囊的上邊界,左邊界,右邊界相對於屏幕左上角的起點的位置,所以我們是不是可以用(膠囊上邊界距離頂部的距離 – 狀態欄的高度)*2+膠囊的高度,就是標題欄的高度呢?然後再在標題欄裡面添加一個文本區讓他的高度等於膠囊的高度,實現flex佈局的上下居中是不是就搞定瞭呢?

以上呢其實針對小程序平臺的導航欄講解,那麼既然使用uniapp,就會考慮到多端情況

那麼其實我們使用uniapp獲取到的狀態欄在h5,小程序和app原生都是有效的,h5網頁中一般我們都是直接采用瀏覽器內核給我們內置的網頁導航欄,就是一個頭部,沒有過多的要求,而且瀏覽器不同,給我們提供的頭部導航也不一樣。

而對於app端,我們沒有瞭像微信小程序中那種讓人心煩的膠囊之後,我們隻需要知道狀態欄的高度,然後加上自己業務需求的標題欄樣式和標題欄高度就行啦

所以我們在進行自定義導航欄封裝的時候就要對代碼進行條件編譯啦。那麼我這裡呢是把微信小程序做瞭單獨的處理,微信小程序之外的平臺看作是統一狀態

獻上源碼:

首先我們把獲取設備信息的代碼封裝到一個統一的js文件裡面,這樣方便我們在組件中獲取也方便我們在頁面中獲取。

/**
 * 此js文件管理關於當前設備的機型系統信息
 */
const systemInfo = function() {
	/****************** 所有平臺共有的系統信息 ********************/
	// 設備系統信息
	let systemInfomations = uni.getSystemInfoSync()
	// 機型適配比例系數
	let scaleFactor = 750 / systemInfomations.windowWidth
	// 當前機型-屏幕高度
	let windowHeight = systemInfomations.windowHeight * scaleFactor //rpx
	// 當前機型-屏幕寬度
	let windowWidth = systemInfomations.windowWidth * scaleFactor //rpx
	// 狀態欄高度
	let statusBarHeight = (systemInfomations.statusBarHeight) * scaleFactor //rpx
 
	// 導航欄高度  註意:此導航欄高度隻針對微信小程序有效 其他平臺如自定義導航欄請使用:狀態欄高度+自定義文本高度
	let navHeight = 0 //rpx
	// console.log(windowHeight,'哈哈哈哈哈');
	
	/****************** 微信小程序頭部膠囊信息 ********************/
	// #ifdef MP-WEIXIN
	const menuButtonInfo = wx.getMenuButtonBoundingClientRect()
	// 膠囊高度
	let menuButtonHeight = menuButtonInfo.height * scaleFactor //rpx
	// 膠囊寬度
	let menuButtonWidth = menuButtonInfo.width * scaleFactor //rpx
	// 膠囊上邊界的坐標
	let menuButtonTop = menuButtonInfo.top * scaleFactor //rpx
	// 膠囊右邊界的坐標
	let menuButtonRight = menuButtonInfo.right * scaleFactor //rpx
	// 膠囊下邊界的坐標
	let menuButtonBottom = menuButtonInfo.bottom * scaleFactor //rpx
	// 膠囊左邊界的坐標
	let menuButtonLeft = menuButtonInfo.left * scaleFactor //rpx
 
	// 微信小程序中導航欄高度 = 膠囊高度 + (頂部距離 - 狀態欄高度) * 2
	navHeight = menuButtonHeight + (menuButtonTop - statusBarHeight) * 2
	// #endif
 
 
	// #ifdef MP-WEIXIN
	return {
		scaleFactor,
		windowHeight,
		windowWidth,
		statusBarHeight,
		menuButtonHeight,
		menuButtonWidth,
		menuButtonTop,
		menuButtonRight,
		menuButtonBottom,
		menuButtonLeft,
		navHeight
	}
	// #endif
 
	// #ifndef MP-WEIXIN
	return {
		scaleFactor,
		windowHeight,
		windowWidth,
		statusBarHeight
	}
	// #endif
}
 
export {
	systemInfo
}

然後我們定義一個導航欄組件

/*
* 註意:
* 1、在傳入寬度或者高度時,如果是Number數據,傳入的值為px大小,無需帶單位,組件自動計算
* 2、在使用此導航欄時,建議傳入UI規定的導航欄高度,此高度隻針對除微信小程序的其他平臺有效,微信小程序的導航欄高度,組件自計算
*/
<template>
	<view>
		<!-- 微信小程序頭部導航欄 -->
		<!-- #ifdef MP-WEIXIN -->
		<view class="wx-head-mod" :style="{height:navHeight+'rpx',backgroundColor:navBackgroundColor}">
			<view class="wx-head-mod-nav" :style="{height:navigationBarHeight+'rpx',top:statusBarHeight+'rpx'}">
				<view class="wx-head-mod-nav-content"
					:style="{height:customHeight+'rpx',justifyContent:textAlign === 'center'?'center':'left'}">
					<!-- 文本區 -->
					<view class="wx-head-mod-nav-content-mian"
						:style="{width:navTextWidth,lineHeight:customHeight + 'rpx',paddingLeft:textPaddingLeft*scaleFactor+'rpx',fontSize:fontSize*scaleFactor+'rpx',fontWeight:fontWeight,color:titleColor}">
						{{textContent}}
					</view>
					<!-- 返回按鈕 -->
					<view class="wx-head-mod-nav-content-back" :style="{display:isBackShow?'flex':'none'}"
						@click="backEvent">
						<view class="wx-head-mod-nav-content-back-img"
							:style="{width:backImageWidth*scaleFactor+'rpx',height:backImageHeight*scaleFactor+'rpx'}">
							<image :src="backImageUrl" mode="" style="width: 100%;height: 100%;"></image>
						</view>
					</view>
				</view>
			</view>
		</view>
		<!-- #endif -->
 
		<!-- 除微信小程序之外的其他設備 -->
		<!-- #ifndef MP-WEIXIN -->
		<view class="other-head-mod"
			:style="{height:navHeightValue*scaleFactor+statusBarHeight+'rpx',backgroundColor:navBackgroundColor}">
			<view class="other-head-mod-mian"
				:style="{height:navHeightValue*scaleFactor+'rpx',justifyContent:textAlign === 'center'?'center':'left'}">
				<!-- 返回按鈕 -->
				<view class="other-head-mod-mian-back" v-show="isBackShow" @click="backEvent">
					<view class="other-head-mod-mian-back-img"
						:style="{width:backImageWidth*scaleFactor+'rpx',height:backImageHeight*scaleFactor+'rpx'}">
						<image :src="backImageUrl" mode="" style="width: 100%;height: 100%;"></image>
					</view>
				</view>
				<!-- 標題 -->
				<view class="other-head-mod-mian-title" :style="{width:windowWidth - 184+'rpx',lineHeight:navHeightValue*scaleFactor+'rpx',
					paddingLeft:textPaddingLeft*scaleFactor+'rpx',fontSize:fontSize*scaleFactor+'rpx',
					fontWeight:fontWeight,color:titleColor}">
					{{textContent}}
				</view>
			</view>
		</view>
		<!-- #endif -->
	</view>
</template>
 
<script>
	const app = getApp()
	import {systemInfo} from '@/common/system-info.js'
	export default {
		name: "HeadView",
		props: {
			// 文本區域位置 left:左  center:中  
			textAlign: {
				type: String,
				default: 'center'
			},
			// 文本區內容
			textContent: {
				type: String,
				default: '哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈就啊哈哈好借好還'
			},
			// 文本區離左邊的距離
			textPaddingLeft: {
				type: Number,
				default: 16
			},
			// 是否需要返回按鈕
			isBackShow: {
				type: Boolean,
				default: true
			},
			// 文本區字體大小
			fontSize: {
				type: Number,
				default: 20 //px
			},
			// 文本區字體粗細
			fontWeight: {
				type: Number,
				default: 700
			},
			// 文本區返回按鈕圖片寬
			backImageWidth: {
				type: Number,
				default: 12 //px
			},
			// 文本區返回按鈕圖片高
			backImageHeight: {
				type: Number,
				default: 24 //px
			},
			// 返回按鈕圖標路徑
			backImageUrl: {
				type: String,
				default: '/static/backImage.svg'
			},
			// 導航欄整體背景顏色
			navBackgroundColor: {
				type: String,
				default: '#2476F9'
			},
			// 標題字體顏色
			titleColor: {
				type: String,
				default: '#ffffff',
			},
 
			/******** h5端,app端需要傳入自定義導航欄高度 *******/
			navHeightValue: {
				type: Number,
				default: 44 //px
			}
		},
		computed: {
			// 文本區寬度
			navTextWidth() {
				if (this.textAlign === 'center') {
					return (this.windowWidth - (this.windowWidth - this.menubarLeft) * 2) + 'rpx'
				} else {
					return this.menubarLeft + 'rpx'
				}
			},
			// 文本區paddingLeft
			textPaddingleft() {
				if (this.textAlign === 'center') {
					return '0'
				} else {
					return this.textPaddingLeft + 'rpx'
				}
			}
		},
		data() {
			return {
				statusBarHeight: app.globalData.statusBarHeight, //狀態欄高度
				navHeight: app.globalData.navHeight, //頭部導航欄總體高度
				navigationBarHeight: app.globalData.navigationBarHeight, //導航欄高度
				customHeight: app.globalData.customHeight, //膠囊高度
				scaleFactor: app.globalData.scaleFactor, //比例系數
				menubarLeft: app.globalData.menubarLeft, //膠囊定位的左邊left
				windowWidth: app.globalData.windowWidth * app.globalData.scaleFactor
			};
		},
		methods: {
			backEvent() {
				uni.navigateBack({
					delta: 1
				})
			}
		},
		created() {
			/* 獲取設備信息 */
			const SystemInfomations = systemInfo()
			/* 通用平臺 */
			this.statusBarHeight = SystemInfomations.statusBarHeight //狀態欄高度
			this.scaleFactor = SystemInfomations.scaleFactor //比例系數
			this.windowWidth = SystemInfomations.windowWidth //當前設備的屏幕寬度
			/* 微信小程序平臺 */
			// #ifdef MP-WEIXIN
			this.navHeight = SystemInfomations.navHeight + SystemInfomations.statusBarHeight //頭部導航欄總高度
			this.navigationBarHeight = SystemInfomations.navHeight //頭部導航欄高度
			this.customHeight = SystemInfomations.menuButtonHeight //膠囊高度
			this.menubarLeft = SystemInfomations.menuButtonLeft //膠囊左邊界距離左上角的距離
			// #endif
			
		}
	}
</script>
 
<style>
	/* #ifdef MP-WEIXIN */
	.wx-head-mod {
		box-sizing: border-box;
		width: 100%;
		position: fixed;
		top: 0;
		left: 0;
	}
 
	.wx-head-mod-nav {
		box-sizing: border-box;
		width: 100%;
		position: absolute;
		left: 0;
		display: flex;
		justify-content: center;
		align-items: center;
 
	}
 
	.wx-head-mod-nav-content {
		box-sizing: border-box;
		width: 100%;
		display: flex;
		justify-content: left;
		align-items: center;
		position: relative;
	}
 
	/* 文本區 */
	.wx-head-mod-nav-content-mian {
		box-sizing: border-box;
		height: 100%;
		white-space: nowrap;
		text-overflow: ellipsis;
		overflow: hidden;
	}
 
	/* 返回按鈕 */
	.wx-head-mod-nav-content-back {
		box-sizing: border-box;
		width: 60rpx;
		height: 100%;
		/* background-color: aqua; */
		position: absolute;
		top: 0;
		left: 32rpx;
		display: flex;
		align-items: center;
		justify-content: left;
	}
 
	.wx-head-mod-nav-content-back-img {
		box-sizing: border-box;
	}
 
	/* #endif */
 
	/* #ifndef MP-WEIXIN */
	.other-head-mod {
		box-sizing: border-box;
		width: 100%;
		position: fixed;
		top: 0;
		left: 0;
	}
 
	.other-head-mod-mian {
		box-sizing: border-box;
		width: 100%;
		display: flex;
		align-items: center;
		justify-content: left;
		position: absolute;
		left: 0;
		bottom: 0;
	}
 
	/* 返回按鈕 */
	.other-head-mod-mian-back {
		box-sizing: border-box;
		height: 100%;
		width: 60rpx;
		position: absolute;
		left: 32rpx;
		top: 0;
		display: flex;
		align-items: center;
	}
 
	/* 標題 */
	.other-head-mod-mian-title {
		box-sizing: border-box;
		height: 100%;
		white-space: nowrap;
		text-overflow: ellipsis;
		overflow: hidden;
	}
 
	/* #endif */
</style>

組件使用:

引入組件:

import HeadNav from '@/components/HeadNav.vue'

組冊組件:

components:{
			HeadNav
		},
<template>
	<view class="content">
		<head-nav></head-nav>
		<view class="content-main"></view>
	</view>
</template>

效果圖:

微信小程序:

h5:

app:

 在項目裡面沒有針對h5時候需要導航欄做特別的限制,如果實際開發中在h5端不需要此導航欄,請在模版上面針對h5頁面加入條件編譯即可。

總結

到此這篇關於uniapp微信小程序自定義導航欄的文章就介紹到這瞭,更多相關uniapp自定義導航欄內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!

推薦閱讀: