uni.getWindowInfo()
同步获取窗口信息
返回值
GetWindowInfoResult 属性值
| 名称 | 类型 | 必备 | 默认值 | 描述 |
|---|
| pixelRatio | number | 是 | - | 设备像素比 |
| screenWidth | number | 是 | - | 屏幕宽度 |
| screenHeight | number | 是 | - | 屏幕高度 |
| windowWidth | number | 是 | - | 可使用窗口宽度 |
| windowHeight | number | 是 | - | 可使用窗口高度 |
| statusBarHeight | number | 是 | - | 状态栏的高度 |
| windowTop | number | 是 | - | 可使用窗口的顶部位置 |
| windowBottom | number | 是 | - | 可使用窗口的底部位置 |
| safeArea | SafeArea | 是 | - | 在竖屏正方向下的安全区域 |
| safeAreaInsets | SafeAreaInsets | 是 | - | 在竖屏正方向下的安全区域插入位置 |
| screenTop | number | 是 | - | 窗口上边缘的 y 值 |
SafeArea 属性值
| 名称 | 类型 | 必备 | 默认值 | 描述 |
|---|
| left | number | 是 | - | 安全区域左上角横坐标 |
| right | number | 是 | - | 安全区域右下角横坐标 |
| top | number | 是 | - | 安全区域左上角纵坐标 |
| bottom | number | 是 | - | 安全区域右下角纵坐标 |
| width | number | 是 | - | 安全区域的宽度，单位逻辑像素 |
| height | number | 是 | - | 安全区域的高度，单位逻辑像素 |
SafeAreaInsets 属性值
| 名称 | 类型 | 必备 | 默认值 | 描述 |
|---|
| left | number | 是 | - | 安全区域左侧插入位置 |
| right | number | 是 | - | 安全区域右侧插入位置 |
| top | number | 是 | - | 安全区顶部插入位置 |
| bottom | number | 是 | - | 安全区域底部插入位置 |
getWindowInfo 兼容性
| 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
|---|
| 4.4 | √ | 3.9.0 | 9.0 | √ | x |
参见
getWindowInfo
通用类型
GeneralCallbackResult
| 名称 | 类型 | 必备 | 默认值 | 描述 |
|---|
| errMsg | string | 是 | - | 错误信息 |
