目录

如何获取状态栏等避让区进行避让

问题现象

如何获取状态栏,导航栏,挖孔区等避让区具体高度进行避让。具体场景有以下几个。

场景一:避让区为顶部状态栏,底部导航栏,在屏幕旋转,窗口大小变化时需要动态避让。

场景二:沉浸式应用变为悬浮窗、分屏模式时,顶部窗口控制条需要避让。

场景三:设备旋转情况下的挖孔区域需要避让。

背景知识

解决方案

设备

布局时要注意的避让区

手机

手机上需避让顶部信号栏、底部导航条安全区、与两侧margin,有需要时预留键盘占据的空间

折叠设备

除顶部信号栏与底部导航条以外,需避免将关键信息放置在折叠设备的转轴区(即折痕处)

平板

平板基础布局需避让顶部信号栏、底部导航条安全区、与两侧margin(根据断点规则计算)

智能穿戴

智能穿戴产品的信息布局需要根据设备为圆表或方表,以及当前应用的实际内容进行设计。避让水平屏幕边缘间距的同时,在不同的界面架构中,需要考量垂直布局额外进行避让

常见FAQ

Q:getWindowAvoidArea函数获取的高度单位是什么。

A:该方式获取的高度单位为px。若要显示为vp格式需要用px2vp函数转换:

Q:使用setPreferredOrientation切换横竖屏时应用一侧有白边。

A:如果module.json5中是否配置了挖孔区域避让,如果设置了避让,会导致应用两侧留白不一致。

Q:使用windowClass.getWindowAvoidArea(window.AvoidAreaType.TYPE_SYSTEM).topRect获取刘海屏高度时height、top的含义。

A:top指刘海屏原点(矩形左上角)距离屏幕顶端的像素值,left为距屏幕左侧的像素值,width和height分别为刘海屏所在外包矩形的宽高。