最近写小程序时,遇到了 iPhoneX 底部小黑线与内容重叠的问题,其实是iPhoneX安全区域的适配问题,了解清楚这个问题花了挺多时间的,也实操出告终果,忍不住来总结总结。javascript
前言
· 内容与小黑线重叠状况说明
1.安全区域含义
2.微信小程序适配iPhoneX底部小黑条(Home Indicator)
(1)适配方案一:使用已知底部小黑条高度34px/68rpx来适配(不推荐)
(2)适配方案二:使用微信官方API,getSystemInfo()中的safeArea对象进行适配(推荐)
(3)适配方案三:使用苹果官方推出的css函数env()、constant()来适配 (推荐)
3.H5适配iPhoneX底部小黑条(Home Indicator)
· 适配方案:使用苹果官方推出的css函数env()、constant()来适配 (推荐)css
在苹果 iPhoneX 、iPhone XR等设备上,能够看到物理Home键被取消,改成底部小黑条替代home键功能。微信小程序和 h5 网页须要针对这种状况进行适配,不然可能会遇到底部按钮或选项卡栏与底部黑线重叠的状况,以下图。html
想要解决内容与小黑线重叠的问题,咱们须要先了解清楚苹果对于安全区域的定义。java
安全区域指的是一个可视窗口范围,处于安全区域的内容不受圆角(corners)、齐刘海(sensor housing)、小黑条(Home Indicator)的影响。ios
看看苹果官方给的这2张图就明白了,中间蓝色区域即为安全区域。也就是说,适配安全区域也就是让小程序或者H5的内容显示在蓝色区域部分。程序员
同时安全区域是在IOS11以后而且是iPhoneX及以上机型才有的,因此须要适配的是这一类机型(为了方便,下文中统称这类须要适配的机型为iPhoneX),更老的机型则不须要考虑适配问题。web
三种方案:正则表达式
这是比较老的方法,跟方案二、3比已经不推荐了,你们能够了解了解,着急能够直接看方案2和3。小程序
从网上了解到,iPhone底部的小黑条(Home Indicator)高度是34px,实际我也在真机确认了是34px,因此能够根据该值,设置底部按钮或选项卡的margin-bottom、padding-bottom、height等,或者添加一个div来占位小黑条的位置。微信小程序
这样作要有一个前提,须要判断当前机型是须要适配安全区域的机型。
2种方案:
wx.getSystemInfoSync()
的model
属性判断wx.getSystemInfoSync()
中的screenHeight
和safeArea
对象的bottom
属性判断wx.getSystemInfoSync()
的model
属性判断已知市面上已有的带安全区域的苹果设备包括iPhone X、iPhone XR、iPhone XS Max、iPhone 十一、iPhone 11 Pro、iPhone 11 Pro Max,因此能够直接从getSystemInfoSync()方法中拿到model属性进行判断。iPhone系列微信还未适配手机的model返回值为unknown(iphone),也能够提早作适配。
let IPHONE_X = /iphone x/i let IPHONE_X_11 = /iphone 11/i let IPHONE_UNKNOWN = /unknown\(iphone\)/i //方法一:使用model判断是不是IPhoneX及其余包含安全区域的机型手机 const isIPhoneX = () => { let model = wx.getSystemInfoSync().model return (model.search(IPHONE_X) > -1 || model.search(IPHONE_X_11) > -1 || model.search(IPHONE_UNKNOWN) > -1) } //也可使用正则表达式判断 const isIPhoneXRegex = () => { let model = wx.getSystemInfoSync().model return (/iphone\sx/i.test(model) || (/iphone/i.test(model) && /unknown/.test(model)) || /iphone\s11/i.test(model)) }
wx.getSystemInfoSync()
中的screenHeight
和safeArea
对象的bottom
属性判断这里使用screenHeight
而不是windowHeight
,由于bottom
是以屏幕左上角为原点开始计算的,因此须要的是屏幕高度,对比screenHeight
和bottom
,若是相等则说明不须要适配,不相等则须要适配。
**注意:**若是使用微信开发者工具中的模拟器,screenHeight和bottom始终是相等的,须要用真机来测试。
//方法二:使用wx.getSystemInfoSync()中的screenHeight和safeArea的bottom判断 const isIPhoneX = () => { let screenHeight = wx.getSystemInfoSync().screenHeight let bottom = wx.getSystemInfoSync().safeArea.bottom return screenHeight !== bottom }
解决了如何判断设备是iPhoneX的问题,就能够写代码了。
<view class="bottom-button {{isIpX ? 'view-IPX' : ''}}">底部按钮</view>
使用wx. getSystemInfo()中的safeArea对象获取底部小黑条的高度
step 1:使用上面讲的方法先判断是不是须要适配的iPhone机型
step 2:若是是须要适配的机型,使用safeArea中的bottom,获得安全区域底部纵坐标,而后使用screenHeight减去bottom就能获得小黑条的高度。保存到localstorage里面,全局均可以使用。
苹果官方推荐使用env()
,constant()
来适配,建议使用该方案,不须要管数值具体是多少。这2个方法是什么呢?
由于目标是须要对底部小黑条作适配,因此只须要关注safe-area-inset-bottom
这个值。
而env()和constant()函数有个必要的使用前提,当网页设置viewport-fit=cover
的时候才生效,根据微信小程序的表现和我在实际真机测试时这两个函数生效,推测小程序里的viewport-fit
默认是cover
。
有一点要注意,在IOS11.2系统之前,可使用constant()函数,可是在IOS11.2系统之后,这个函数就被废弃了,被env()函数替代了。官方原话以下:
The env() function shipped in iOS 11 with the name constant(). Beginning with Safari Technology Preview 41 and the iOS 11.2 beta, constant() has been removed and replaced with env(). You can use the CSS fallback mechanism to support both versions, if necessary, but should prefer env() going forward.
因此咱们在作屏幕适配时,须要这样写:
padding-bottom: constant(safe-area-inset-bottom); /*兼容 IOS<11.2*/ padding-bottom: env(safe-area-inset-bottom); /*兼容 IOS>11.2*/
**注意:**env()和constant()须要同时存在,并且顺序不能换。
在H5上适配安全区域就方便多了,采用viewport+env+constant方案。
viewport-fit 默认有3个值:
contain和cover具体区别以下图:
而咱们须要将viewport设置为cover,env和constant才能生效。设置代码以下:
<meta name="viewport" content="width=device-width,initial-scale=1.0,viewport-fit=cover">
同时设置env和constant代码,一样env()和constant()须要同时存在,并且顺序不能换。
/* 能够经过增长padding-bottom来适配 */ padding-bottom: constant(safe-area-inset-bottom); /*兼容 IOS<11.2*/ padding-bottom: env(safe-area-inset-bottom); /*兼容 IOS>11.2*/ /* 能够经过margin-bottom来适配 */ margin-bottom: constant(safe-area-inset-bottom); margin-bottom: env(safe-area-inset-bottom); /* 或者改变高度*/ height: calc(55px + constant(safe-area-inset-bottom)); height: calc(55px + env(safe-area-inset-bottom));
也能够在底部添加一个空白的div颜色块来作适配。
还有一种是使用 @supports 隔离兼容样式
可使用 @supports 来隔离兼容样式,当浏览器支持bottom: constant(safe-area-inset-bottom)
或者bottom: env(safe-area-inset-bottom)
的时候,bottom-button
类就会新增margin-bottom
的样式
@supports (bottom: constant(safe-area-inset-bottom)) or (bottom: env(safe-area-inset-bottom)) { .bottom-button { margin-bottom: constant(safe-area-inset-bottom); margin-bottom: env(safe-area-inset-bottom); } }
以上就是我对iPhoneX安全区域(Safe Area)底部小黑条在微信小程序和H5适配的总结。
若是对你有帮助的话,点赞、评论、赞扬都是对个人鼓励,也是支持我写下去的动力,谢谢!
参考文章:
本文原创发布于微信公众号「程序员张晴天」,欢迎关注第一时间获取最新分享,一块儿进步。