提交 bb0ad025 编写于 作者: DCloud-yyl's avatar DCloud-yyl

补充安全区域说明

上级 895c78c1
......@@ -12,16 +12,19 @@
![](https://web-ext-storage.dcloud.net.cn/uni-app-x/API/getWindowInfo/size.png)
### 安全区域说明
### 安全区域说明 @safearea
由于部分手机屏幕有顶部的“刘海”和底部导航的存在,为了确保内容区域不被遮挡,提出了安全区域,以便于在安全区域内布局。
app-android平台全屏模式下分安全区域字段说明:
- safeArea.top : statusBarHeight
- safeArea.bottom: statusBarHeight + 应用导航栏高度 + windowHeight + tabbar高度
- safeArea.height: safeArea.bottom - safeArea.top
app-android平台全屏模式下分安全区域字段说明:
- safeArea.top : statusBarHeight
- safeArea.bottom: statusBarHeight + 应用导航栏高度 + windowHeight + tabbar高度
- safeArea.height: safeArea.bottom - safeArea.top
- safeAreaInsets: 安全区域与可渲染内容区域边界的距离
iOS端safeArea与iOS原生的安全区域概念相同,top与bottom分别对应`window.safeAreaInsets.top` `window.safeAreaInsets.bottom`,具体请参照[Apple文档](https://developer.apple.com/documentation/uikit/uiview/positioning_content_relative_to_the_safe_area)
HBuilderX4.31版本页面内容可渲染区域在设备系统导航栏设置为`全面屏手势`时,调整为可渲染到手势指示条区域,如不想将页面内容渲染到此区域,可在页面底部设置占位view,其高度为safeAreaInsets.bottom值。
app-ios平台safeArea与iOS原生的安全区域概念相同,top与bottom分别对应`window.safeAreaInsets.top` `window.safeAreaInsets.bottom`,具体请参照[Apple文档](https://developer.apple.com/documentation/uikit/uiview/positioning_content_relative_to_the_safe_area)
::: warning 注意事项
- `screenWidth`/`screenHeight`获取的是设备屏幕宽高信息
......
......@@ -170,7 +170,7 @@ pages节点里注册页面,数据格式是数组,数组每个项都是一个
- 下拉刷新
* pages.json中下拉刷新是页面级配置,方便使用但灵活度有限。
* 如需自定义下拉刷新,请使用[scroll-view](../component/scroll-view.md)[list-view](../component/list-view.md)的下拉刷新。
- Android系统导航栏 (通常指手机底部按钮或手势提示线区域)
- Android系统导航栏 (通常指手机底部按钮或手势指示条区域)
* 系统导航栏的背景颜色与backgroundColorContent颜色一致,导航栏的前景色会根据backgroundColorContent颜色自动适配 (4.21版本开始支持)
* tabBar页面的系统导航栏背景颜色取值策略[参考](#tabbar-tips)
* 系统导航栏为全面屏手势时,HBuilderX4.31版本调整页面内容可以渲染到手势指示条区域(低版本页面内容会自动避开手势指示条区域),如需适配可以通过[uni.getWindowInfo](../api/get-window-info.md)获取安全区域底部插入位置信息进行适配
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册