【HarmonyOS】键盘遮挡输入框UI布局处理

【HarmonyOS】键盘遮挡输入框UI布局处理

问题背景:

在开发输入框UI时,特别是登录页面的密码输入框靠下,或者是评论底部的pop弹框。

当我们输入框获得焦点后,键盘自下而上显示,一般情况下会遮挡住我们的UI布局。
导致用户输入时,键盘遮挡看不到自己输入的内容。

解决方案:

在鸿蒙应用开发中,我们针对键盘遮挡问题,通过窗口设置键盘遮挡模式来解决。目前键盘遮挡界面时,可以压缩窗口UI 或者 将窗口UI向上抬起两种方式:

dart 复制代码
import { KeyboardAvoidMode, UIContext } from '@kit.ArkUI';

aboutToAppear(): void {
  this.uiContext.setKeyboardAvoidMode(KeyboardAvoidMode.RESIZE);
}

// 需要注意的是,这里的上下文uiContext是窗口级别的上下文UIContext,并不是普通context。

 this.uiContext = this.getUIContext(); // √
  this.uiContext = getContext(); // x


// uiContext最方便的获取方式是,在当前界面中通过:
  this.getUIContext().setKeyboardAvoidMode(KeyboardAvoidMode.RESIZE);

// 当在逻辑类中想要拿到uiContext就只能通过单例或者AppStorage进行存储获取。例如:

import { KeyboardAvoidMode, UIContext } from '@kit.ArkUI';
import { hilog } from '@kit.PerformanceAnalysisKit';

onWindowStageCreate(windowStage: window.WindowStage) {
    windowStage.loadContent('pages/Index', (err, data) => {
    	globalThis.SysContext = windowStage.getMainWindowSync().getUIContext(); 
    	
		// 或者你的整个app都需要应用键盘遮挡模式,就可以直接在window创建的时候进行设置,没必要每个界面内调用设置。
      uiContext.setKeyboardAvoidMode(KeyboardAvoidMode.RESIZE);
      if (err.code) {
        return;
      }
    });
  }

1.界面UI压缩 KeyboardAvoidMode.RESIZE

2.界面UI抬起 KeyboardAvoidMode.OFFSET

当被抬起的界面中有不需要抬起的控件,如上图所示,其中的的标题栏控件就设置了 .expandSafeArea([SafeAreaType.KEYBOARD])}。

![在这里插入图片描述](https://i-blog.csdnimg.cn/direct/a724bf42c1aa482cb79267f357125e6d.png

相关推荐
zhujian826371 天前
十七、【鸿蒙 NEXT】如何实现lottie动画
华为·harmonyos·lottie
大雷神1 天前
[鸿蒙2025领航者闯关]HarmonyOS中开发高德地图第十篇:综合实战案例
harmonyos
大雷神1 天前
[鸿蒙2025领航者闯关]HarmonyOS中开发高德地图第六篇:POI搜索功能
harmonyos
盐焗西兰花1 天前
鸿蒙学习实战之路 - 应用追踪实践最佳实践
学习·华为·harmonyos
大雷神1 天前
[鸿蒙2025领航者闯关]HarmonyOS中开发高德地图第二篇:显示第一个地图
harmonyos
ujainu1 天前
Flutter与DevEco Studio协同开发:HarmonyOS应用实战指南
flutter·华为·harmonyos
赵财猫._.1 天前
【Flutter x 鸿蒙】第四篇:双向通信——Flutter调用鸿蒙原生能力
flutter·华为·harmonyos
赵财猫._.1 天前
【Flutter x 鸿蒙】第五篇:导航、路由与多设备适配
flutter·华为·harmonyos
Chaunceyin1 天前
浅谈Openharmony 和 HarmonyOS
华为·harmonyos
●VON1 天前
从单端到“空地一体”:基于 HarmonyOS 的多端协同感知系统开发实践
学习·华为·harmonyos·openharmony·开源鸿蒙