uni.getWindowInfo()

获取窗口信息

App	H5	微信小程序	支付宝小程序	抖音小程序	快手小程序	QQ小程序	百度小程序	京东小程序	钉钉小程序	飞书小程序	元服务
√ (3.4.13+)	√ (3.4.13+)	√ (2.20.1+)	x	x	x	x	x	x	x	x	x

getWindowInfo 兼容性

HarmonyOS
HBuilderX 4.23

返回参数说明

参数名	类型	说明	平台差异说明
pixelRatio	number	设备像素比
screenWidth	number	屏幕宽度
screenHeight	number	屏幕高度
windowWidth	number	可使用窗口宽度
windowHeight	number	可使用窗口高度
windowTop	number	可使用窗口的顶部位置
windowBottom	number	可使用窗口的底部位置
statusBarHeight	number	手机状态栏的高度
screenTop	number	窗口上边缘的 y 值
safeArea	object	在竖屏正方向下的安全区域
safeAreaInsets	object	在竖屏正方向下的安全区域插入位置

safeArea 的结构

参数	类型	说明
left	Number	安全区域左上角横坐标
right	Number	安全区域右下角横坐标
top	Number	安全区域左上角纵坐标
bottom	Number	安全区域右下角纵坐标
width	Number	安全区域的宽度，单位逻辑像素
height	Number	安全区域的高度，单位逻辑像素

safeAreaInsets 的结构

参数	类型	说明
left	Number	安全区域左侧插入位置
right	Number	安全区域右侧插入位置
top	Number	安全区顶部插入位置
bottom	Number	安全区域底部插入位置

返回值

类型	描述
GetWindowInfoResult	result
名称 类型 必填 默认值 兼容性 描述 pixelRatio number 是 - HarmonyOS HBuilderX 4.23 设备像素比 statusBarHeight number 是 - HarmonyOS HBuilderX 4.23 状态栏的高度，单位为px windowTop number 是 - HarmonyOS HBuilderX 4.23 内容区域距离顶部的距离（同CSS变量 --window-top），单位为px windowBottom number 是 - HarmonyOS HBuilderX 4.23 内容区域距离底部的距离（同CSS变量 --window-bottom），单位为px safeArea SafeArea 是 - HarmonyOS HBuilderX 4.23 安全区域在屏幕中的位置信息 safeAreaInsets SafeAreaInsets 是 - HarmonyOS HBuilderX 4.23 安全区域插入位置（与屏幕边界的距离）信息 cutoutArea Array<CutoutRect> 否 - HarmonyOS x 挖孔、刘海区域在屏幕中的位置信息 screenTop number 是 - HarmonyOS HBuilderX 4.23 窗口上边缘的 y 值，单位为px 已废弃，仅为了向下兼容保留 windowHeight number 是 - HarmonyOS HBuilderX 4.23 可使用窗口高度，单位为px 已废弃，仅为了向下兼容保留 windowWidth number 是 - HarmonyOS HBuilderX 4.23 可使用窗口宽度，单位为px 已废弃，仅为了向下兼容保留 screenHeight number 是 - HarmonyOS HBuilderX 4.23 屏幕高度，单位为px 已废弃，仅为了向下兼容保留 screenWidth number 是 - HarmonyOS HBuilderX 4.23 屏幕宽度，单位为px 已废弃，仅为了向下兼容保留