uniapp 打包成APP或小程序后或H5后 IOS(iphoneX机型) 底部安全区域适配(避开底部黑条虚拟键)

2024-06-04 8475阅读

一、IOS 安全区域适配( 配置方法 )


在 manifest.json 文件的 "app-plus" 节点下添加 "safearea" 适配 iOS 的安全区域,

"background" 对应正常模式下安全区域外的背景颜色,

"backgroundDark"对应暗黑模式(夜间模式 / 深色模式)下安全区域外的背景颜色

"app-plus" : {
	"safearea": { //iOS平台的安全区域
		"background": "#ffffff",//正常模式下安全区域外的背景颜色
		"backgroundDark": "#2f0508", //应暗黑模式下安全区域外的背景颜色 HX 3.1.19+支持
		"bottom": {
			"offset": "auto"//开启原生安全区域占位
		}
	}
}

二、IOS 安全区域适配( CSS方法适配)


APP端不index.php/tags-602.html" class="superseo">使用配置,非APP端可不配置

"app-plus" : {
	"safearea": { //iOS平台的安全区域
		"bottom": {
			"offset": "none"//关闭原生安全区域占位
		}
	}
}

 然后使用CSS常量  constant(safe-area-inset-bottom) 、env(safe-area-inset-bottom) 来适配,如下在需要适配的页面元素中使用,将下面CSS放入公共样式中,通过类名快速调用

比如为列表底部添加内边距避开安全区,在 iPhoneX 上列表底部会有内边距,在其他设备上没有内边距:

/* iPhoneX底部安全区定义*/
.safe-area-inset-bottom {
  padding-bottom: 0;  
  padding-bottom: constant(safe-area-inset-bottom);  
  padding-bottom: env(safe-area-inset-bottom);  
} 

可以用于高度(height),间距(margin)示例如下: 

/* 设置padding-bottom*/
padding-bottom: constant(safe-area-inset-bottom); //兼容 IOS11.2
/* 设置高度*/
height: calc(100px + constant(safe-area-inset-bottom));
height: calc(100px + env(safe-area-inset-bottom));
/* 设置margin-bottom*/
margin-bottom: constant(safe-area-inset-bottom);
margin-bottom: env(safe-area-inset-bottom);

constant()函数是WebKit的CSS函数,用于在小程序中设置底部安全距离。而env()函数是CSS的通用函数,可以在任何支持的环境中使用

注意:

  • 当网页设置viewport-fit=cover的时候才生效(uniapp开发,小程序无需设置,默认viewport-fit=cover)
  • constant()和env()需要同时存在,顺序不能换。
  • nvue 页面不支持 css 常量,可以使用 uni.getSystemInfo 获取 safeAreaInsets 动态设置到 元素的style 属性中。
  • 使用pages.json里配置的原生tabbar的tabbar页面,无需处理,原生tabbar会自动适配。

    免责声明:我们致力于保护作者版权,注重分享,被刊用文章因无法核实真实出处,未能及时与作者取得联系,或有版权异议的,请联系管理员,我们会立即处理! 部分文章是来自自研大数据AI进行生成,内容摘自(百度百科,百度知道,头条百科,中国民法典,刑法,牛津词典,新华词典,汉语词典,国家院校,科普平台)等数据,内容仅供学习参考,不准确地方联系删除处理! 图片声明:本站部分配图来自人工智能系统AI生成,觅知网授权图片,PxHere摄影无版权图库和百度,360,搜狗等多加搜索引擎自动关键词搜索配图,如有侵权的图片,请第一时间联系我们,邮箱:ciyunidc@ciyunshuju.com。本站只作为美观性配图使用,无任何非法侵犯第三方意图,一切解释权归图片著作权方,本站不承担任何责任。如有恶意碰瓷者,必当奉陪到底严惩不贷!

    目录[+]