# uni.getWindowInfo()

同步获取窗口信息

# 返回值

类型
GetWindowInfoResult
名称 类型 必备 默认值 描述
pixelRatio number - 设备像素比
screenWidth number - 屏幕宽度,单位为px
screenHeight number - 屏幕高度,单位为px
windowWidth number - 可使用窗口宽度,单位为px
windowHeight number - 可使用窗口高度,单位为px
statusBarHeight number - 状态栏的高度,单位为px
windowTop number - 内容区域距离顶部的距离(同CSS变量 --window-top),单位为px
windowBottom number - 内容区域距离底部的距离(同CSS变量 --window-bottom),单位为px
safeArea SafeArea - 在竖屏正方向下的安全区域
名称 类型 必备 默认值 描述
left number - 安全区域左上角横坐标,单位为px
right number - 安全区域右下角横坐标,单位为px
top number - 安全区域左上角纵坐标,单位为px
bottom number - 安全区域右下角纵坐标,单位为px
width number - 安全区域的宽度,单位为px
height number - 安全区域的高度,单位为px
safeAreaInsets SafeAreaInsets - 在竖屏正方向下的安全区域插入位置
名称 类型 必备 默认值 描述
left number - 安全区域左侧插入位置,单位为px
right number - 安全区域右侧插入位置,单位为px
top number - 安全区顶部插入位置,单位为px
bottom number - 安全区域底部插入位置,单位为px
screenTop number - 窗口上边缘的 y 值,单位为px

# getWindowInfo 兼容性

Android iOS web
3.9 4.11 4.0

# 参见

相关 Bug

# 示例

hello uni-app x

Template

Script

<template>
  <page-head :title="title"></page-head>
  <view class="uni-common-mt">
    <view class="uni-list">
      <view class="uni-list-cell" v-for="(item, _) in items" style="align-items: center">
        <view class="uni-pd">
          <view class="uni-label" style="width: 180px">{{ item.label }}</view>
        </view>
        <view class="uni-list-cell-db">
          <text style="width: 100%;">{{ item.value == '' ? '未获取' : item.value }}</text>
        </view>
      </view>
    </view>
    <view class="uni-padding-wrap">
      <view class="uni-btn-v">
        <button type="primary" @tap="getWindowInfo">获取窗口信息</button>
      </view>
    </view>
  </view>
</template>


<style>
  .uni-pd {
    padding-left: 15px;
  }
</style>

# 通用类型

# GeneralCallbackResult

名称 类型 必备 默认值 描述
errMsg string - 错误信息