UI 视觉设计 / 系统课时

处理软键盘遮挡与输入焦点

处理软键盘遮挡与输入焦点

任务编辑页包含多个输入框时,软键盘弹出会压缩可视区域,导致底部字段、错误提示或保存按钮被遮挡。本课以 Material Design 3 任务表单为例,设计键盘展开后的滚动策略、输入焦点顺序和提交行为,并给出可以直接交付开发与测试的验收标准。

学习目标

  • 规划软键盘展开后的可视区域、滚动容器和底部操作区。
  • 为单行与多行文本框设置合理的焦点顺序和键盘操作键。
  • 验证键盘遮挡、输入错误、系统返回及不同窗口尺寸下的表单行为。

根据键盘高度调整可视区域

以宽 360dp、高 800dp 的任务编辑页面为例,顶部包含应用栏,正文依次为任务名称、任务地点和备注,底部有保存按钮。

假设键盘占据屏幕底部 300dp,在暂不考虑系统栏的示意坐标中,键盘上缘位于 y=500dp。若备注输入组的底边位于 y=620dp,就会被键盘覆盖。

要让整个输入组连同辅助文字距离键盘上缘至少 16dp,需要使其底边不超过 484dp。因此本例至少向上滚动 136dp。这里的 300dp 和 16dp 分别是演示用键盘高度与项目自定间距,不是所有设备的固定规范。

页面结构应采用以下处理方式:

  1. 顶部应用栏保留在页面顶部,不随表单内容滚动。
  2. 输入字段放入纵向滚动容器,允许键盘出现时继续滚动。
  3. 滚动容器根据实际键盘占用空间调整可用高度,不将键盘高度写死。
  4. 底部保存操作区不能停留在键盘背后。空间足够时可移动至键盘上方;空间不足时可在输入期间暂时收起,键盘关闭后恢复。
  5. 在滚动内容末尾保留足够的内边距,使最后一个字段及其错误说明能够完整进入可视区域。

对于 Android 原生应用,开发侧应处理 IME 与系统栏的 WindowInsets。特别是 Android 15(API 35)及以上、目标 SDK 为 35 及以上的边到边布局,不能仅根据屏幕总高度推断安全区域。实现依据可参考 Android 软件键盘官方文档。

让焦点跟随键盘与滚动位置

用户点击输入框后,不能只弹出键盘而保持原有页面位置。焦点、键盘和滚动容器需要联动。

建议将交互过程明确为以下步骤:

  1. 用户点击任务地点或备注,当前字段获得输入焦点,显示符合主题的聚焦状态。
  2. 系统键盘展开,页面重新计算键盘上方的可用区域。
  3. 若聚焦字段被遮挡,滚动容器将该字段移动到可视区域内,同时保留标签和辅助文字。
  4. 用户移动到下一个字段时,重新检查目标字段是否可见,必要时再次滚动。
  5. 键盘收起时恢复正常布局,但不清空已经输入的数据,也不擅自提交表单。

如果多行备注输入框本身高于可视区域,应优先保证当前光标及正在编辑的文字可见,而不是强求整个文本框始终完整显示。

任务表单软键盘遮挡修正与输入焦点移动示意

常见错误是直接把整个页面向上平移一个固定距离。键盘高度会随输入法、候选词栏、屏幕方向和设备变化,这种处理可能把页面标题推出屏幕,或仍然留下被遮挡的字段。

正确方案是使用动态可视区域与可滚动内容,并根据实际聚焦字段决定滚动量,而不是每次都将表单强制滚到最顶部。

配置输入顺序与键盘操作键

键盘上的操作键应与字段语义相符。单行字段可以使用“下一个”,最后一个单行字段可以使用“完成”;多行备注如果需要输入换行,回车键应保留换行行为。

本例任务编辑页采用以下配置:

当前字段 输入类型 键盘操作 执行行为
任务名称 单行文本 下一个 焦点移动到任务地点
任务地点 单行文本 下一个 焦点移动到备注
备注 多行文本 换行 插入新行,不提交表单
保存按钮 表单操作 点击保存 校验字段并提交

按照这张表进行原型设计时,需要区分三种行为。

第一种是焦点移动。用户在任务名称字段点击键盘上的“下一个”,焦点应直接进入任务地点,并在需要时自动滚动。用户不必先手动关闭键盘再点击另一个字段。

第二种是输入结束。若某个表单最后一项是单行文本,可以配置“完成”来结束编辑并收起键盘,但“完成”不应在没有明确设计约定时自动提交整个表单。

第三种是表单提交。本例的备注是多行输入,因此必须保留回车换行能力。用户通过页面上的保存按钮完成提交。若键盘展开时暂时收起了保存操作区,用户可先使用系统返回关闭键盘,再点击保存。

处理错误焦点与系统返回

表单校验失败时,错误信息不能只出现在键盘背后的页面底部。应将焦点移到需要修正的字段,并保证错误文字同时可见。

例如用户填写了任务地点和备注,却将必填的任务名称留空。点击保存后,页面应执行以下行为:

  1. 阻止本次提交,保留用户已经填写的其他字段。
  2. 定位第一个未通过校验的字段,即任务名称。
  3. 将任务名称设置为错误状态,显示“请输入任务名称”。
  4. 滚动页面,使任务名称、错误说明及必要的上下文处于可视区域内。
  5. 用户修正后,按预先定义的校验时机清除错误状态,再允许重新提交。

系统返回也需要区分键盘与页面导航。键盘打开时,用户执行系统返回通常应先关闭键盘,而不是直接退出整个任务编辑页。键盘关闭后再次返回,才按页面自身的导航与未保存内容规则处理。

若页面存在未保存修改,可以在真正离开编辑页时提供放弃修改的确认,而不是在每次关闭键盘时弹出确认框。

交付原型并验证关键状态

在 Figma 中,至少准备键盘收起、键盘展开和字段校验错误三种状态。设计标注应明确哪些区域固定、哪些区域滚动、键盘展开时保存按钮如何处理,以及焦点移动后的目标位置。

采用以下测试矩阵验收,不仅检查静态截图,还要实际操作输入法。

测试场景 操作 通过标准
底部输入 点击备注 光标和当前编辑文字不被键盘遮挡
焦点移动 在任务名称点击下一个 焦点进入任务地点,目标字段可见
多行输入 在备注中按回车 文本正常换行,没有意外提交
校验失败 清空名称后保存 显示错误并定位到名称字段
系统返回 键盘打开时返回 优先关闭键盘,输入内容保留
窗口变化 改用横屏或较矮窗口 仍可滚动访问全部字段和保存操作

建议至少使用 360dp 宽的常规手机、320dp 宽的窄屏,以及横屏或分屏状态进行检查,并增加字体放大测试。还应验证不同输入法及候选词栏展开状态,因为实际键盘高度并不一致。

交付给开发的规格中,应同时包含字段顺序、键盘操作类型、滚动触发条件、底部操作区策略和错误后的焦点去向。只交付一张键盘弹出的静态设计图,无法完整说明这些行为。

验收时以用户能否连续输入、看到当前字段与错误信息、主动完成保存为判断依据。只要键盘高度改变仍不会遮挡关键操作,焦点路径也不会中断,这套表单交互才算完成。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理软键盘遮挡与输入焦点

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通