news 2026/4/16 9:20:24

【HarmonyOS NEXT】解决:软键盘弹起导致页面整体上移、标题栏丢失的问题

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
【HarmonyOS NEXT】解决:软键盘弹起导致页面整体上移、标题栏丢失的问题

一、背景

在开发鸿蒙 APP 登录页时,会遇到这样的体验问题,当用户点击输入框弹出软键盘时,整个页面会被默认的上推模式带起,导致顶部的标题栏被推出可视区域,严重影响用户体验。

备注:以下解决方法为(API 11+),低版本不适配哦!

二、具体问题

页面分为三个部分,顶部固定标题,中间是logo图标,底部是输入框。用户点击底部输入框时,页面弹出软键盘,顶部固定标题没有固定住,整体往上移动。

问题效果预览:图1是没弹出软键盘的场景,图2是弹出软键盘的场景。

问题代码示例如下:

@Extend(TextInput) function commonInputStyle(maxLength: number) { .placeholderColor('#999999') .borderRadius(8) .contentType(ContentType.PHONE_NUMBER) .caretStyle({ color: '#b35336', width: 2 }) .height(48) .maxLength(maxLength) .maxLines(1) .type(InputType.Number) .fontColor('#333333') .width("100%") .backgroundColor(Color.White) .padding({ left: 16, right: 16 }) .shadow({ radius: 4, color: '#00000008', offsetY: 2 }) } @Entry @Component export struct Index { @State phoneNumber: string = "" @State codeNumber: string = "" build() { Column() { Stack({ alignContent: Alignment.Top }) { Column() .width('100%') .height('100%') .backgroundColor('#F8F9FA') // 标题栏 Column() { Text('密码登录') .fontColor('#333333') .fontSize(20) .fontWeight(500) .margin({ top: 10 }) // logo模块 Image($r("app.media.startIcon")) .width(120) .objectFit(ImageFit.Contain) .margin({ top: 110, bottom: 60 }) .borderRadius(16) .shadow({ radius: 8, color: '#00000010', offsetY: 4 }) // 输入模块 Column() { TextInput({ text: this.phoneNumber, placeholder: "请输入手机号" }) .commonInputStyle(11) .onChange((value: string) => { this.phoneNumber = value }) TextInput({ text: this.codeNumber, placeholder: "请输入短信验证码" }) .commonInputStyle(6) .margin({ top: 20 }) .onChange((value: string) => { this.codeNumber = value }) } .width('100%') .padding({ top: 200, left: 32, right: 32 }) } .width('100%') .height('100%') .justifyContent(FlexAlign.Start) } } .width('100%') .height('100%') } }

三、问题定位

3.1、确定问题

标题栏无固定布局,依赖页面整体排版,键盘弹起时随页面上移丢失

首先默认场景下UI是没有啥问题的,主要是在键盘弹起后UI整体上移了,那问题就出现键盘弹起的过程上,是没有正确配置键盘避让模式

3.2、键盘背景知识:

官网文档指引👉:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-e#keyboardavoidmode11

KeyboardAvoidMode配置键盘避让页面的避让模式,其中KeyboardAvoidMode.RESIZE表示压缩模式

四、解决问题

核心方案:配置setKeyboardAvoidMode(KeyboardAvoidMode.RESIZE)(API 11+)

解决软键盘弹出后顶部控件无法固定的问题,可以通过setKeyboardAvoidMode来配置虚拟键盘弹出时,页面的避让模式为压缩模式。

在aboutToAppear生命周期里面配置键盘避让模式为压缩模式👇

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/3/30 11:06:27

学长亲荐!自考必备TOP10一键生成论文工具深度测评

学长亲荐!自考必备TOP10一键生成论文工具深度测评 自考论文写作工具测评:为何要关注2026年榜单? 对于正在备战自考的学子来说,撰写一篇结构严谨、内容充实的论文是毕业路上的关键一环。然而,面对繁杂的资料收集、格式排…

作者头像 李华
网站建设 2026/4/9 23:40:01

‌AI自动生成测试用例优先级评分:基于历史缺陷密度的全面研究

测试优先级自动化的必要性‌在软件开发生命周期中,测试用例优先级评分(Test Case Prioritization, TCP)是确保高效回归测试的关键环节。它通过为测试用例分配权重,优先执行高风险或高影响案例,从而优化资源分配。传统方…

作者头像 李华
网站建设 2026/4/2 3:38:24

Instagram十亿级“用户名已被占用“背后的架构设计

点击标题下「蓝色微信名」可快速关注尽管国内无法访问但已经火遍全球的Ins软件,即Instagram,可能很多朋友都了解或者接触过,例如最近北京国安要引进的新外援,就是球迷们根据国安总经理马永明(Matthias Brosamer&#x…

作者头像 李华
网站建设 2026/4/2 6:41:36

无人驾驶十年演进

下面这份内容,不是厂商路线图,也不是技术名词堆砌,而是站在**“无人驾驶作为长期运行、规模化落地的社会系统”视角,对未来十年的一次结构性演进判断**。🚘 无人驾驶十年演进(2025–2035) 一、核…

作者头像 李华
网站建设 2026/4/2 5:20:52

教育平台如何用百度UE实现PPT内容无缝转存至网页?

CMS企业官网Word导入全攻略:一个.NET码农的求生之路 兄弟们好!我是福建某小公司的.NET码农,最近接了个CMS企业官网的外包活,客户爸爸要求加个"Word全家桶一键导入"功能,还要保留所有妖艳的样式。预算680元封…

作者头像 李华