鸿蒙开发 - 键盘避让

最近几天优化了项目关于输入框的优化,崩溃至极,差点哭了,原因是各个页面都没有配置键盘避让模式,又加上页面功能优化,导致各个页面都出现键盘乱蹦。

整理一下键盘避让的实现方法

页面配置:

TypeScript 复制代码
aboutToAppear(): void {
// 上抬模式,页面会整体上抬,使输入框漏出
 this.getUIContext().setKeyboardAvoidMode(KeyboardAvoidMode.OFFSET);

// 压缩模式,使页面中间部分设置百分比的布局进行压缩, 使输入框漏出
this.getUIContext().setKeyboardAvoidMode(KeyboardAvoidMode.RESIZE);

}

根据自己情况选择合适的方式

布局配置

KeyboardAvoidMode.RESIZE 模式下:

压缩Page的大小,Page下设置百分比(一定要有layoutWeight(1)的组件)宽高的组件会跟随Page压缩,直接设置宽高的组件会按设置的固定大小布局。设置KeyboardAvoidMode.RESIZE时,expandSafeArea(SafeAreaType.KEYBOARD,SafeAreaEdge.BOTTOM)不生效。

假如 List 组件上部有其他组件A那么一定会被顶到标题栏,可以考虑将组件A移动到List组件中

设置不避让

当然了我们开发中也会存在一些场景,不想让组件随键盘移动而避让,那么可以为单个组件设置:

.expandSafeArea(SafeAreaType.KEYBOARD)

还差最后一步

选好了避让模式,调整好了页面布局,一点输入框,键盘抬起了,输入框也不遮盖了, 还差一步,list的内容得滚动到最后一条啊,不然要被产品说的。

TypeScript 复制代码
//监听软键盘抬起落下,比安卓方便那么一点点
aboutToAppear(): void {
    window.getLastWindow(getContext(this)).then(currentWindow => {
      let property = currentWindow.getWindowProperties();
      let avoidArea = currentWindow.getWindowAvoidArea(window.AvoidAreaType.TYPE_SYSTEM);
      // 初始化显示区域高度
      this.screenHeight = px2vp(property.windowRect.height - avoidArea.topRect.height - avoidArea.bottomRect.height);
      // 监视软键盘的弹出和收起
      currentWindow.on('avoidAreaChange', async data => {
        if (data.type !== window.AvoidAreaType.TYPE_KEYBOARD) {
          return;
        }
        if (data.area.bottomRect.height <= 0) {
          this.isKeyBoardHidden = true;
        } else {
          this.isKeyBoardHidden = false;
        }
        this.screenHeight = px2vp(property.windowRect.height - avoidArea.topRect.height - data.area.bottomRect.height);
      })
    })
  }

哦了, 大部分软件应用场景就这些吧,参考一下,我一边写才发现了官方文档

官方指导:文档中心

相关推荐
李洋-蛟龙腾飞公司12 分钟前
HarmonyOS Dev Assistant安装基本流程与使用(一)
华为·harmonyos·harmonyos next
Sunny_GMF13 分钟前
所见即所得编辑器原理实战:源码与渲染永不失真的三层一致性设计(Markdown/CodeMirror 装饰)
microsoft·编辑器·ai编程·harmonyos
fellow9923 分钟前
鸿蒙真机调试三板斧:Playwright 为什么驱动不了 Electron-on-鸿蒙
华为·electron·harmonyos
GitCode官方26 分钟前
开源鸿蒙跨平台直播|Flutter HCPP 开源鸿蒙实践:让原生视图回到系统合成层
flutter·华为·harmonyos
动物园猫34 分钟前
Compose Multiplatform 三方库 Calendar(kizitonwose)的 OpenHarmony 鸿蒙化适配实战
华为·harmonyos
三掌柜66639 分钟前
ArkWeb 手记 04|Web 返回键别再一刀切
前端·harmonyos
Token_w9 小时前
2026鸿蒙平板远控电脑怎么选?大屏适配、自动校准等适配完整度逐项实测
华为·harmonyos
传奇开心果编程10 小时前
【SwiftUI娓娓道来】第3课:让界面活起来——交互与动画指南
学习·macos·ui·ios·swiftui·swift
梦想不只是梦与想10 小时前
鸿蒙应用市场:版本升级
harmonyos·应用升级·签名不一致
resh_people11 小时前
开源鸿蒙平台 KMP_CMP 三方库「WhatIf」适配全流程
华为·开源·harmonyos