Uni-app页面信息与元素影响解析

获取窗口信息uni.getWindowInfo

json 复制代码
{
	pixelRatio: 3
	safeArea:{
		bottom: 778
		height: 731
		left: 0
		right: 375
		top: 47
		width: 375
	}
	safeAreaInsets: {
		top: 47, 
		left: 0, 
		right: 0, 
		bottom: 34
	},
	screenHeight: 812,
	screenTop: 0,
	screenWidth: 375,
	statusBarHeight: 47,
	windowBottom: 0,
	windowHeight: 812,
	windowTop: 0,
	windowWidth: 375
}

参数的含义

uni.getWindowInfo()​方法用于获取当前窗口的相关信息,其返回结果包含以下属性1:

  1. pixelRatio:设备像素比。
  2. screenWidth:屏幕宽度,单位为逻辑像素。
  3. screenHeight:屏幕高度,单位为逻辑像素。
  4. windowWidth:可使用的窗口宽度,单位为逻辑像素。
  5. windowHeight:可使用的窗口高度,单位为逻辑像素。
  6. windowTop:可使用窗口的顶部位置,即窗口顶部距离屏幕顶部的距离,单位为逻辑像素。
  7. windowBottom:可使用窗口的底部位置,即窗口底部距离屏幕顶部的距离,单位为逻辑像素。
  8. statusBarHeight:手机状态栏的高度,单位为逻辑像素。
  9. screenTop:窗口顶部边缘的y值,即窗口顶部距离屏幕顶部的距离,与windowTop类似,但在某些情况下可能有不同的计算方式或用途。
  10. safeArea:一个对象,包含了竖屏正方向下安全区域的信息,包括以下属性:
复制代码
 * ​`left`​:安全区域左上角的横坐标,单位为逻辑像素。
 * ​`right`​:安全区域右下角的横坐标,单位为逻辑像素。
 * ​`top`​:安全区域左上角的纵坐标,单位为逻辑像素。
 * ​`bottom`​:安全区域右下角的纵坐标,单位为逻辑像素。
 * ​`width`​:安全区域的宽度,单位为逻辑像素。
 * ​`height`​:安全区域的高度,单位为逻辑像素。
  1. safeAreaInsets:一个对象,包含了竖屏正方向下安全区域的插入位置信息,包括以下属性:
复制代码
 * ​`left`​:安全区域左侧的插入位置,单位为逻辑像素。
 * ​`right`​:安全区域右侧的插入位置,单位为逻辑像素。
 * ​`top`​:安全区域顶部的插入位置,单位为逻辑像素。
 * ​`bottom`​:安全区域底部的插入位置,单位为逻辑像素。

示例图

在不同的机型上返回的参数对比如下:

  • 如果当前页面中没有在 pages中设置导航栏,windowHeight 与 screenHeight 高度相同

相关推荐
00后程序员张1 小时前
Windows 下怎么生成 AppStoreInfo.plist?不依赖 Xcode 的方法
ide·macos·ios·小程序·uni-app·iphone·xcode
__zRainy__2 小时前
uni-app 全局容器实战系列(二):Vite 虚拟模块
windows·uni-app
__zRainy__2 小时前
uni-app 全局容器实战系列(一):全局容器的实现
uni-app·vite
安生生申4 小时前
uni-app 连接 JDY-31 蓝牙串口模块实践
c语言·前端·javascript·stm32·单片机·嵌入式硬件·uni-app
小离a_a4 小时前
uniapp小程序封装圆环显示比例数据
android·小程序·uni-app
__zRainy__4 小时前
uni-app 全局容器实战系列(三):全局 NavBar 和 TabBar 组件设计
uni-app
一颗小青松18 小时前
uniapp输入框fixed定位,导致页面顶起解决方案
前端·uni-app
2501_915106321 天前
深入解析无源码iOS加固原理与方案,保护应用安全
android·安全·ios·小程序·uni-app·cocoa·iphone
万能小林子1 天前
2026 AI开发新范式:Vibe Coding生成网页 + 3分钟打包成App,非技术人也能独立发布自己的App!
人工智能·uni-app·ai编程·web app·vibecoding