From f0837d38b5af217a74239282b28635aba22154b7 Mon Sep 17 00:00:00 2001 From: DCloud-yyl Date: Fri, 23 Aug 2024 19:18:01 +0800 Subject: [PATCH] Update get-window-info.md --- docs/api/get-window-info.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/api/get-window-info.md b/docs/api/get-window-info.md index 2a95d253..4db0a4a7 100644 --- a/docs/api/get-window-info.md +++ b/docs/api/get-window-info.md @@ -8,16 +8,15 @@ -下图标注了不同区域的高度 +下图标注了各区域信息 -![](https://web-ext-storage.dcloud.net.cn/uni-app-x/API/getWindowInfo/size.jpg) +![](https://web-ext-storage.dcloud.net.cn/uni-app-x/API/getWindowInfo/size.png) ### 安全区域说明 由于部分手机屏幕有顶部的“刘海”和底部导航的存在，为了确保内容区域不被遮挡，提出了安全区域，以便于在安全区域内布局。 -Android端部分安全区域字段说明： - +app-android平台全屏模式下分安全区域字段说明： - safeArea.top : statusBarHeight - safeArea.bottom: statusBarHeight + 标题栏高度 + windowHeight + tabbar高度 - safeArea.height: safeArea.bottom - safeArea.top @@ -25,6 +24,8 @@ Android端部分安全区域字段说明： iOS端safeArea与iOS原生的安全区域概念相同，top与bottom分别对应`window.safeAreaInsets.top` `window.safeAreaInsets.bottom`，具体请参照[Apple文档](https://developer.apple.com/documentation/uikit/uiview/positioning_content_relative_to_the_safe_area) ::: warning 注意事项 +- `screenWidth`/`screenHeight`获取的是设备屏幕宽高信息 + + app平台应用在非全屏模式（如“浮窗”或“分屏”）时，仍然返回的设备屏幕的宽高 - `windowWidth`/`windowHeight`获取的是当前栈顶页面的可使用窗口宽高信息，调用此API前如果打开了新页面，可能获取到的是新开页面的信息 + app平台需要在页面渲染后才能获取到准确信息，稳妥起见，建议在页面生命周期`onReady`后获取 - `windowTop`/`windowBottom` 在app平台页面内容无法渲染顶部默认导航栏或底部tabBar区域，返回的值一定为0 -- GitLab