UI 视觉设计 / 系统课时
处理软键盘遮挡与输入焦点
处理软键盘遮挡与输入焦点
任务编辑页包含多个输入框时,软键盘弹出会压缩可视区域,导致底部字段、错误提示或保存按钮被遮挡。本课以 Material Design 3 任务表单为例,设计键盘展开后的滚动策略、输入焦点顺序和提交行为,并给出可以直接交付开发与测试的验收标准。
学习目标
- 规划软键盘展开后的可视区域、滚动容器和底部操作区。
- 为单行与多行文本框设置合理的焦点顺序和键盘操作键。
- 验证键盘遮挡、输入错误、系统返回及不同窗口尺寸下的表单行为。
根据键盘高度调整可视区域
以宽 360dp、高 800dp 的任务编辑页面为例,顶部包含应用栏,正文依次为任务名称、任务地点和备注,底部有保存按钮。
假设键盘占据屏幕底部 300dp,在暂不考虑系统栏的示意坐标中,键盘上缘位于 y=500dp。若备注输入组的底边位于 y=620dp,就会被键盘覆盖。
要让整个输入组连同辅助文字距离键盘上缘至少 16dp,需要使其底边不超过 484dp。因此本例至少向上滚动 136dp。这里的 300dp 和 16dp 分别是演示用键盘高度与项目自定间距,不是所有设备的固定规范。
页面结构应采用以下处理方式:
- 顶部应用栏保留在页面顶部,不随表单内容滚动。
- 输入字段放入纵向滚动容器,允许键盘出现时继续滚动。
- 滚动容器根据实际键盘占用空间调整可用高度,不将键盘高度写死。
- 底部保存操作区不能停留在键盘背后。空间足够时可移动至键盘上方;空间不足时可在输入期间暂时收起,键盘关闭后恢复。
- 在滚动内容末尾保留足够的内边距,使最后一个字段及其错误说明能够完整进入可视区域。
对于 Android 原生应用,开发侧应处理 IME 与系统栏的 WindowInsets。特别是 Android 15(API 35)及以上、目标 SDK 为 35 及以上的边到边布局,不能仅根据屏幕总高度推断安全区域。实现依据可参考 Android 软件键盘官方文档。
让焦点跟随键盘与滚动位置
用户点击输入框后,不能只弹出键盘而保持原有页面位置。焦点、键盘和滚动容器需要联动。
建议将交互过程明确为以下步骤:
- 用户点击任务地点或备注,当前字段获得输入焦点,显示符合主题的聚焦状态。
- 系统键盘展开,页面重新计算键盘上方的可用区域。
- 若聚焦字段被遮挡,滚动容器将该字段移动到可视区域内,同时保留标签和辅助文字。
- 用户移动到下一个字段时,重新检查目标字段是否可见,必要时再次滚动。
- 键盘收起时恢复正常布局,但不清空已经输入的数据,也不擅自提交表单。
如果多行备注输入框本身高于可视区域,应优先保证当前光标及正在编辑的文字可见,而不是强求整个文本框始终完整显示。

常见错误是直接把整个页面向上平移一个固定距离。键盘高度会随输入法、候选词栏、屏幕方向和设备变化,这种处理可能把页面标题推出屏幕,或仍然留下被遮挡的字段。
正确方案是使用动态可视区域与可滚动内容,并根据实际聚焦字段决定滚动量,而不是每次都将表单强制滚到最顶部。
配置输入顺序与键盘操作键
键盘上的操作键应与字段语义相符。单行字段可以使用“下一个”,最后一个单行字段可以使用“完成”;多行备注如果需要输入换行,回车键应保留换行行为。
本例任务编辑页采用以下配置:
| 当前字段 | 输入类型 | 键盘操作 | 执行行为 |
|---|---|---|---|
| 任务名称 | 单行文本 | 下一个 | 焦点移动到任务地点 |
| 任务地点 | 单行文本 | 下一个 | 焦点移动到备注 |
| 备注 | 多行文本 | 换行 | 插入新行,不提交表单 |
| 保存按钮 | 表单操作 | 点击保存 | 校验字段并提交 |
按照这张表进行原型设计时,需要区分三种行为。
第一种是焦点移动。用户在任务名称字段点击键盘上的“下一个”,焦点应直接进入任务地点,并在需要时自动滚动。用户不必先手动关闭键盘再点击另一个字段。
第二种是输入结束。若某个表单最后一项是单行文本,可以配置“完成”来结束编辑并收起键盘,但“完成”不应在没有明确设计约定时自动提交整个表单。
第三种是表单提交。本例的备注是多行输入,因此必须保留回车换行能力。用户通过页面上的保存按钮完成提交。若键盘展开时暂时收起了保存操作区,用户可先使用系统返回关闭键盘,再点击保存。
处理错误焦点与系统返回
表单校验失败时,错误信息不能只出现在键盘背后的页面底部。应将焦点移到需要修正的字段,并保证错误文字同时可见。
例如用户填写了任务地点和备注,却将必填的任务名称留空。点击保存后,页面应执行以下行为:
- 阻止本次提交,保留用户已经填写的其他字段。
- 定位第一个未通过校验的字段,即任务名称。
- 将任务名称设置为错误状态,显示“请输入任务名称”。
- 滚动页面,使任务名称、错误说明及必要的上下文处于可视区域内。
- 用户修正后,按预先定义的校验时机清除错误状态,再允许重新提交。
系统返回也需要区分键盘与页面导航。键盘打开时,用户执行系统返回通常应先关闭键盘,而不是直接退出整个任务编辑页。键盘关闭后再次返回,才按页面自身的导航与未保存内容规则处理。
若页面存在未保存修改,可以在真正离开编辑页时提供放弃修改的确认,而不是在每次关闭键盘时弹出确认框。
交付原型并验证关键状态
在 Figma 中,至少准备键盘收起、键盘展开和字段校验错误三种状态。设计标注应明确哪些区域固定、哪些区域滚动、键盘展开时保存按钮如何处理,以及焦点移动后的目标位置。
采用以下测试矩阵验收,不仅检查静态截图,还要实际操作输入法。
| 测试场景 | 操作 | 通过标准 |
|---|---|---|
| 底部输入 | 点击备注 | 光标和当前编辑文字不被键盘遮挡 |
| 焦点移动 | 在任务名称点击下一个 | 焦点进入任务地点,目标字段可见 |
| 多行输入 | 在备注中按回车 | 文本正常换行,没有意外提交 |
| 校验失败 | 清空名称后保存 | 显示错误并定位到名称字段 |
| 系统返回 | 键盘打开时返回 | 优先关闭键盘,输入内容保留 |
| 窗口变化 | 改用横屏或较矮窗口 | 仍可滚动访问全部字段和保存操作 |
建议至少使用 360dp 宽的常规手机、320dp 宽的窄屏,以及横屏或分屏状态进行检查,并增加字体放大测试。还应验证不同输入法及候选词栏展开状态,因为实际键盘高度并不一致。
交付给开发的规格中,应同时包含字段顺序、键盘操作类型、滚动触发条件、底部操作区策略和错误后的焦点去向。只交付一张键盘弹出的静态设计图,无法完整说明这些行为。
验收时以用户能否连续输入、看到当前字段与错误信息、主动完成保存为判断依据。只要键盘高度改变仍不会遮挡关键操作,焦点路径也不会中断,这套表单交互才算完成。