# 安全区适配
# 底部安全区
这个适配,主要是针对IPhone X等一些底部带指示条的机型,指示条的操作区域与页面底部存在重合,容易导致用户误操作,因此我们需要针对这些机型进行底部安全区适配。
zxUI是uni-app态的UI框架uni-app专门针对底部安全区域的解决方案,具体如下(也可见uni官方说明全面屏、刘海屏适配(iphoneX适配)及安全区设置 (opens new window)):
- 在APP上(以下只对APP生效),可以通过项目根目录的
mainfest.json
文件app-plus
节点下配置safearea
的bottom
属性为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-popup
、zx-keyboard
组件等,提供了一个safeAreaInsetBottom
参数(布尔类型),如果设置为true
,就会在组件内部对安全区进行适配,
从而避免安全区指示条引起的问题,以下为zxUI的zx-keyboard
组件在微信浏览器
中分别设置safeAreaInsetBottom
参数
为false
和true
的表现: