记录–优雅解决uniapp微信小程序右上角胶囊菜单覆盖问题

  • 记录–优雅解决uniapp微信小程序右上角胶囊菜单覆盖问题已关闭评论
  • 77 次浏览
  • A+
所属分类:Web前端
摘要

大家好,今天聊一下在做uniapp多端适配项目,需要用到自定义导航时,如何解决状态栏塌陷及导航栏安全区域多端适配问题,下文只针对H5、APP、微信小程序三端进行适配,通过封装一个通用高阶组件包裹自定义导航栏内容,主要是通过设置padding来使内容始终保持在安全区域,达到低耦合,可复用性强的效果。


这里给大家分享我在网上总结出来的一些知识,希望对大家有所帮助

记录--优雅解决uniapp微信小程序右上角胶囊菜单覆盖问题

前言

大家好,今天聊一下在做uniapp多端适配项目,需要用到自定义导航时,如何解决状态栏塌陷及导航栏安全区域多端适配问题,下文只针对H5、APP、微信小程序三端进行适配,通过封装一个通用高阶组件包裹自定义导航栏内容,主要是通过设置padding来使内容始终保持在安全区域,达到低耦合,可复用性强的效果。

一、创建NavbarWrapper.vue组件

大致结构如下:

<template>   <view class="navbar-wrapper" :style="{     paddingTop: statusBarHeight,     paddingRight: rightSafeArea   }">     <slot/>   </view> </template>  <script>   export default {     name: 'NavbarWrapper',     data() {       return {         // 像素单位         pxUnit: 'px',         // 默认状态栏高度         statusBarHeight: 'var(--status-bar-height)',         // 微信小程序右上角的胶囊菜单宽度         rightSafeArea: 0       }     }   } </script>  <style scoped>   .navbar-wrapper {     /**      * 元素的宽度和高度包括了内边距(padding)和边框(border),      * 而不会被它们所占据的空间所影响      * 子元素继承宽度时,只会继承内容区域的宽度      */     box-sizing: border-box;   } </style>

目的

主要是动态计算statusBarHeight和rightSafeArea的值。

解决方案

在APP端只需一行css代码即可

.navbar-wrapper {     padding-top: var(--status-bar-height); }

下面是关于--status-bar-height变量的介绍:

记录--优雅解决uniapp微信小程序右上角胶囊菜单覆盖问题

从上图可以知道--status-bar-height只在APP端是手机实际状态栏高度,在微信小程序是固定的25px,并不是手机实际状态栏高度;

微信小程序时,除了状态栏高度还需要获取右上角的胶囊菜单所占宽度,保持导航栏在安全区域。

以下使用uni.getWindowInfo()uni.getMenuButtonBoundingClientRect()来分别获取状态栏高度和胶囊相关信息,api介绍如下图所示:

记录--优雅解决uniapp微信小程序右上角胶囊菜单覆盖问题

记录--优雅解决uniapp微信小程序右上角胶囊菜单覆盖问题

主要逻辑代码

在NavbarWrapper组件创建时,做相关计算

created() {   const px = this.pxUnit   // #ifndef H5   // 获取窗口信息   const windowInfo = uni.getWindowInfo()   this.statusBarHeight = windowInfo.statusBarHeight + px   // #endif    // #ifdef MP-WEIXIN   // 获取胶囊左边界坐标   const { left } = uni.getMenuButtonBoundingClientRect()   // 计算胶囊(包括右边距)占据屏幕的总宽度:屏幕宽度-胶囊左边界坐标   this.rightSafeArea = windowInfo.windowWidth - left + px   // #endif }

用法

<NavbarWrapper>   <view class="header">header</view> </NavbarWrapper>

二、多端效果展示

微信小程序

记录--优雅解决uniapp微信小程序右上角胶囊菜单覆盖问题

APP端

记录--优雅解决uniapp微信小程序右上角胶囊菜单覆盖问题

H5端

记录--优雅解决uniapp微信小程序右上角胶囊菜单覆盖问题

三、源码

NavbarWrapper.vue

<template>   <view class="navbar-wrapper" :style="{     paddingTop: statusBarHeight,     paddingRight: rightSafeArea   }">     <slot/>   </view> </template>  <script>   export default {     name: 'NavbarWrapper',     data() {       return {         // 像素单位         pxUnit: 'px',         // 默认状态栏高度         statusBarHeight: 'var(--status-bar-height)',         // 微信小程序右上角的胶囊菜单宽度         rightSafeArea: 0       }     },     created() {       const px = this.pxUnit       // #ifndef H5       // 获取窗口信息       const windowInfo = uni.getWindowInfo()       this.statusBarHeight = windowInfo.statusBarHeight + px       // #endif              // #ifdef MP-WEIXIN       // 获取胶囊左边界坐标       const { left } = uni.getMenuButtonBoundingClientRect()       // 计算胶囊(包括右边距)占据屏幕的总宽度:屏幕宽度-胶囊左边界坐标       this.rightSafeArea = windowInfo.windowWidth - left + px       // #endif     }   } </script>  <style scoped>   .navbar-wrapper {     /**      * 元素的宽度和高度包括了内边距(padding)和边框(border),      * 而不会被它们所占据的空间所影响      * 子元素继承宽度时,只会继承内容区域的宽度      */     box-sizing: border-box;     background-color: deeppink;   } </style>

本文转载于:

https://juejin.cn/post/7309361597556719679

如果对您有所帮助,欢迎您点个关注,我会定时更新技术文档,大家一起讨论学习,一起进步。

 记录--优雅解决uniapp微信小程序右上角胶囊菜单覆盖问题