首頁 > 軟體

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

2022-07-10 18:01:50

前言

相信很多小夥伴在使用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自定義導航欄內容請搜尋it145.com以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援it145.com!


IT145.com E-mail:sddin#qq.com