From 1d84d928dd76161c2501e06efd4f4eed51ac6a5b Mon Sep 17 00:00:00 2001 From: "taohebin@dcloud.io" Date: Wed, 21 Aug 2024 18:05:49 +0800 Subject: [PATCH] Update get-window-info.md --- docs/api/get-window-info.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/api/get-window-info.md b/docs/api/get-window-info.md index cb57c22b..8351a681 100644 --- a/docs/api/get-window-info.md +++ b/docs/api/get-window-info.md @@ -16,12 +16,14 @@ 由于部分手机屏幕有顶部的“刘海”和底部导航的存在，为了确保内容区域不被遮挡，提出了安全区域，以便于在安全区域内布局。 -部分安全区域字段说明： +Android端部分安全区域字段说明： - safeArea.top : statusBarHeight - safeArea.bottom: statusBarHeight + 标题栏高度 + windowHeight + tabbar高度 - safeArea.height: safeArea.bottom - safeArea.top +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 注意事项 - Android端的`windowHeight`属性是有时机的考量的，如果在全局作用域获取`windowHeight`，有可能当前Activity还未加载，所以导航栏和Tabbar的高度是不会计算进去的，稳妥起见，建议在`onReady`或者`onPageShow`内获取`windowheight`。 - `windowHeight`属性是依赖于调用Api时栈顶Page的，比如延迟获取`windowHeight`，很可能页面已经切换了，这时候获取的高度是新的页面的。 -- GitLab