鸿蒙UI开发——键盘弹出避让模式设置

devtools/2025/1/17 23:24:41/

1、概 述

我们在鸿蒙开发时,不免会遇到用户输入场景,当用户准备输入时,会涉及到输入法的弹出,我们的界面针对输入法的弹出有两种避让模式:上抬模式、压缩模式。

下面针对输入法的两种避让模式的设置做简单介绍。

2、设置避让模式

设置虚拟键盘抬起时页面的避让模式,API介绍如下:

setKeyboardAvoidMode(value: KeyboardAvoidMode): void

获取虚拟键盘抬起时的页面避让模式,API介绍如下:

getKeyboardAvoidMode(): KeyboardAvoidMode

其中,KeyboardAvoidMode是一个枚举,默认值为OFFSET上抬模式,定义如下:

OFFSET, // 上抬模式。RESIZE, // 压缩模式。

KeyboardAvoidMode.RESIZE是压缩Page的大小,Page下设置百分比宽高的组件会跟随Page压缩,直接设置宽高的组件会按设置的固定大小布局。

👉🏻 设置为压缩模式

设置虚拟键盘抬起时压缩页面大小为减去键盘的高度。

下面的示例通过调用setKeyboardAvoidMode设置键盘避让模式为RESIZE模式,实现键盘抬起时page的压缩效果。

我们先在EntryAbility中设置避让模式(我们也可以在Page中获取到UIContext动态设置),示例代码如下(第10行):​​​​​​​

// EntryAbility.etsimport { KeyboardAvoidMode } from '@kit.ArkUI';onWindowStageCreate(windowStage: window.WindowStage) {  // Main window is created, set main page for this ability  hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageCreate');  windowStage.loadContent('pages/Index', (err, data) => {    windowStage.getMainWindowSync().getUIContext().setKeyboardAvoidMode(KeyboardAvoidMode.RESIZE);    if (err.code) {      hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');      return;    }    hilog.info(0x0000, 'testTag', 'Succeeded in loading the content. Data: %{public}s', JSON.stringify(data) ?? '');  });}

然后写一个简单的界面,代码如下:​​​​​​​

// xxx.ets@Entry@Componentstruct KeyboardAvoidExample1 {  build() {    Column() {      Row().height("30%").width("100%").backgroundColor(Color.Gray)      TextArea().width("100%").borderWidth(1)      Text("I can see the bottom of the page").width("100%").textAlign(TextAlign.Center).backgroundColor(Color.Pink).layoutWeight(1)    }.width('100%').height("100%")  }}

默认情况下(键盘未弹出),效果如下:

图片

键盘弹出后,效果如下(底部的粉色区域被压缩):

图片

👉🏻 设置为上抬模式

下面的示例通过调用setKeyboardAvoidMode设置键盘避让模式为OFFSET模式,实现键盘抬起时page的上抬效果。

当输入光标距离屏幕底部的高度大于键盘高度时,page不会抬起

我们先在EntryAbility中设置避让模式(我们也可以在Page中获取到UIContext动态设置),示例代码如下(第10行):​​​​​​​

// EntryAbility.etsimport { KeyboardAvoidMode } from '@kit.ArkUI';onWindowStageCreate(windowStage: window.WindowStage) {  // Main window is created, set main page for this ability  hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageCreate');  windowStage.loadContent('pages/Index', (err, data) => {   windowStage.getMainWindowSync().getUIContext().setKeyboardAvoidMode(KeyboardAvoidMode.OFFSET);    if (err.code) {      hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');      return;    }    hilog.info(0x0000, 'testTag', 'Succeeded in loading the content. Data: %{public}s', JSON.stringify(data) ?? '');  });}

然后写一个简单的界面(与Resize的一样),代码如下:​​​​​​​

// xxx.ets@Entry@Componentstruct KeyboardAvoidExample2 {  build() {    Column() {      Row().height("30%").width("100%").backgroundColor(Color.Gray)      TextArea().width("100%").borderWidth(1)      Text("I can see the bottom of the page").width("100%").textAlign(TextAlign.Center).backgroundColor(Color.Pink).layoutWeight(1)    }.width('100%').height("100%")  }}

默认情况下(键盘未弹出),效果如下:

图片

键盘弹出后,效果如下(底部粉色区域的文字被键盘遮挡,同时,由于底部粉色区域高于键盘,所以界面不会因为键盘弹出而发生布局变化):

图片


http://www.ppmy.cn/devtools/151388.html

相关文章

社群团购项目运营策略的深度剖析:融合链动2+1模式、AI智能名片与S2B2C商城小程序的综合应用

摘要:随着互联网技术的飞速发展和消费者购物习惯的不断变化,社群团购作为一种新兴的商业模式,正逐渐成为连接供应商、商家与消费者的重要桥梁。然而,社群团购的成功并非仅限于线上运营,其关键在于项目整体运营的优劣&a…

深度学习中的卷积和反卷积(四)——卷积和反卷积的梯度

本系列已完结,全部文章地址为: 深度学习中的卷积和反卷积(一)——卷积的介绍 深度学习中的卷积和反卷积(二)——反卷积的介绍 深度学习中的卷积和反卷积(三)——卷积和反卷积的计算 …

oneplus3t-lineageos-16.1编译-android9, oneplus3t-lineage-14编译-android7

oneplus3t-lineage-14编译-android7 1 清华linageos镜像 x lineage-14.1-20180223-nightly-oneplus3-signed.zip ntfs分区挂载为普通用户目录 , ext4分区挂载为普通用户目录 bfsu/lineageOS镜像 ts/lingeageOS镜像 oneplus3/lineage-build-simple-manual.md, manifest-p…

python管理工具:conda部署+使用

python管理工具:conda部署使用 一、安装部署 1、 下载 - 官网下载: https://repo.anaconda.com/archive/index.html - wget方式: wget -c https://repo.anaconda.com/archive/Anaconda3-2023.03-1-Linux-x86_64.sh2、 安装 在conda文件的…

HarmonyOS Next 实现登录注册页面(ARKTS) 并使用Springboot作为后端提供接口

1. HarmonyOS next ArkTS ArkTS围绕应用开发在 TypeScript (简称TS)生态基础上做了进一步扩展,继承了TS的所有特性,是TS的超集 ArkTS在TS的基础上扩展了struct和很多的装饰器以达到描述UI和状态管理的目的 以下代码是一个基于…

几种矩阵内积的定义和计算

1. Frobenius Inner Product(矩阵内积) 定义:Frobenius 内积是两个矩阵逐元素乘积的总和。 对于两个维度相同的矩阵 A A A 和 B B B,其内积定义为: ⟨ A , B ⟩ tr ( A T B ) ∑ i 1 m ∑ j 1 n a i j b i j \l…

【C++ 类和对象 进阶篇】—— 逻辑森林的灵动精灵,舞动类与对象的奇幻圆舞曲

欢迎来到ZyyOvO的博客✨,一个关于探索技术的角落,记录学习的点滴📖,分享实用的技巧🛠️,偶尔还有一些奇思妙想💡 本文由ZyyOvO原创✍️,感谢支持❤️!请尊重原创&#x1…

自动化解决方案:修复devicedisplaystatusmanager.dll丢失

在Windows操作系统中,DLL(动态链接库)文件扮演着至关重要的角色。它们为应用程序提供必要的函数和数据,以确保系统的平稳运行。然而,有时我们可能会遇到DLL文件丢失或损坏的问题,比如DeviceDisplayStatusMa…