输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心

HarmonyOS 5.0.0(12)

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
FAQ
您当前浏览的HarmonyOS 5.0.0(API 12)文档归档不再维护，推荐您使用最新版本。详细请参考文档维护策略变更。
FAQ应用框架开发UI框架方舟UI框架（ArkUI）如何获取状态栏和导航栏高度

如何获取状态栏和导航栏高度

更新时间: 2025-04-23 08:50

获取系统状态栏，导航栏等避让区域，使用系统提供的getWindowAvoidArea获取系统规避区域，返回值中的topRect.height即为系统状态栏高度，单位为px。参考代码如下：

收起
自动换行
深色代码主题
复制
  1. // MainAbility.ets
  2. import { common, UIAbility } from '@kit.AbilityKit';
  3. import { window } from '@kit.ArkUI';
  4. 

  5. /**
  6.  * 获取系统状态栏，导航栏高度
  7.  * @param context
  8.  * @returns
  9.  */
  10. async function getWindowAvoidArea(context: common.UIAbilityContext): Promise<window.AvoidArea | null> {
  11.   try {
  12.     const mainWindow = await window.getLastWindow(context);
  13.     const avoidAreaType = window.AvoidAreaType.TYPE_SYSTEM; // 系统默认区域，包括状态栏，导航栏
  14.     const avoidArea = mainWindow.getWindowAvoidArea(avoidAreaType);
  15.     const height = avoidArea.topRect.height;
  16.     return avoidArea
  17.   } catch (e) {
  18.     console.log('getWindowAvoidArea fail');
  19.     return null
  20.   }
  21. }
  22. 

  23. export default class MainAbility extends UIAbility {
  24.   // do something
  25.   async onWindowStageCreate(windowStage: window.WindowStage) {
  26.     getWindowAvoidArea(this.context);
  27.     windowStage.loadContent('pages/index');
  28.   }
  29.   // do something
  30. }

参考链接

getWindowAvoidArea

如何解决window创建的模态窗口默认焦点不在界面上，导致不响应返回事件的问题
如何实现Tabs组件的TabBar从左到右依次排列
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 FAQ 中进行搜索
请输入您想要搜索的关键词