# 安全区适配

# 底部安全区

这个适配,主要是针对IPhone X等一些底部带指示条的机型,指示条的操作区域与页面底部存在重合,容易导致用户误操作,因此我们需要针对这些机型进行底部安全区适配。
zxUI是uni-app态的UI框架uni-app专门针对底部安全区域的解决方案,具体如下(也可见uni官方说明全面屏、刘海屏适配(iphoneX适配)及安全区设置 (opens new window)):

  • 在APP上(以下只对APP生效),可以通过项目根目录的mainfest.json文件app-plus节点下配置safeareabottom属性为none,以此来关闭IPhone X等机型的底部安全区域。 配置后需要重新编译,并重启调试基座才会生效,具体如下:
"app-plus": {
	"safearea": {
		"bottom": {
			"offset": "none"
		}
	}
}

如果offset设置为auto,那么在IPhone X的底部安全区,APP上就会生成一个原生的元素进行占位,此时也就无需解决安全区指示条引起的问题。

  • 在非APP端,诸如小程序,或者微信浏览器(其他浏览器,如UC等手机浏览器,底部有浏览器工具条,不存在安全区指示条引起的问题),底部是没有安全区占位的, 这种情况,就要使用css去解决,一般是通过给元素添加底部内边距的形式,如下:
<style>  
	.list {  
		padding-bottom: 0;  
		padding-bottom: constant(safe-area-inset-bottom);  
		padding-bottom: env(safe-area-inset-bottom);  
	}  
</style>

鉴于以上问题,zxUI提供了一个组件zx-safe-bottom,如果有需要,您可以在任何地方引用它,它会自动判断在并且在IPhone X等机型的时候,给元素加上一个适当 底部内边距,在APP上,即使您保留了原生安全区占位(offset设置为auto),也不会导致底部出现双倍的空白区域,也即APP上offset设置为auto时。

<template>
	<view>
		......
		<zx-safe-bottom></zx-safe-bottom>
	</view>
</template>

# 顶部安全区

由于我们在做页面布局时经常会使用顶部位置,zxUI提供了一个组件zx-status-bar,如zx-popup从顶部弹出时,可以考虑使用此组件。

<template>
	<view>
		<zx-status-bar></zx-status-bar>
		......
	</view>
</template>

# 关于zxUI某些组件safe-area-inset参数的说明

在zxUI中,一些组件如zx-popupzx-keyboard组件等,提供了一个safeAreaInsetBottom参数(布尔类型),如果设置为true,就会在组件内部对安全区进行适配, 从而避免安全区指示条引起的问题,以下为zxUI的zx-keyboard组件在微信浏览器中分别设置safeAreaInsetBottom参数 为falsetrue的表现: