Figma 移动端软键盘弹出(On-Screen Keyboard)与表单视口防遮挡原型实战:Open Overlay 底部推顶、吸底 CTA 上移与 iOS/Android/H5 无偏差交付

2026 年 11 月 21 日

在移动端产品体验验收时,有一个看似细微却极度破坏沉浸感的“经典断点”:设计师交出去的静置态表单页面赏心悦目,可一旦进入真机测试或老板在演示原型里点击了屏幕下半区的输入框,系统软键盘(On-Screen Keyboard)从底部弹起的一瞬间——要么把密码报错提示和“下一步”主按钮挡得严严实实,要么让顶部的对话消息卡死在屏幕外面。

许多设计师把虚拟键盘组件画好了(软键盘组件规范可参考 Figma 交互式虚拟键盘与移动端软键盘系统实战),却不知道如何在 创建交互原型 阶段精准模拟“键盘弹起后视口缩放与吸底栏联动”,更不清楚如何向 iOS、Android 与前端 H5 研发交代避让规则。


一、iOS / Android / H5 软键盘弹出高度与视口重排机制对照 #

在动手搭建防遮挡原型前,必须先统一各端物理键盘高度与视口(Viewport)挤压策略(常见机型画板与安全区基准见 UI 设计规范与主流设备尺寸速查表):

运行平台 / 端侧环境 典型软键盘占用高度(含候选词/工具栏) 底部 Safe Area (34pt) 处理逻辑 主流视口响应模式 高发遮挡与破版坑点
Apple iOS (iPhone 全面屏) 291 ~ 346 pt(英文键盘约 291pt,中文九宫格/全键盘含候选条可达 336~346pt) 软键盘自身已包揽底部 Home Indicator 安全区,紧贴键盘上方的输入框不应再额外叠留 34pt SwiftUI 原生 .ignoresSafeArea(.keyboard) 或监听 UIResponder.keyboardWillShowNotification 上推内容区 研发忘记扣除底部 34pt 安全区,导致键盘与“发送/提交”条之间裂出一条难看的 34pt 大白边
Android (Material 3 / 全面屏) 280 ~ 330 dp(随第三方输入法如搜狗/Gboard 高度浮动) 手势导航条(~24dp)已融入键盘底座 windowSoftInputMode: adjustResize(压缩可视高度) vs adjustPan(整体上推窗口) 误用 adjustPan 导致页面顶部固定导航栏被一起顶出屏幕外;或使用 adjustResize 却没把底部按钮放进滚动区
移动端 Web / 微信 H5 约占屏幕高度 40% ~ 48% iOS Safari 键盘弹起时独立收缩 window.visualViewport.height CSS 100dvh(动态视口)或 JS 监听 visualViewport 偏移底部工具栏 用死板的 100vh 写全屏聊天气泡页,结果 iOS 键盘一弹出把整个页面顶飞、输入框被顶出可视边界

关键设计红线:输入框与主操作按钮之间的“最小安全距”

在设计长表单(如收货地址、实名认证、多字段筛选弹窗)时,任何处于屏幕下方 45% 区域内的输入框,在聚焦态(Focused)下都必须保证“输入框底部 + 报错提示文案 + 主行动按钮(或键盘上方工具条)”能够完整露在剩余 55% 的上半屏可视区内。


二、实操一:用 Open Overlay + Scroll to 打造不遮挡的长表单防呆原型 #

很多设计师在原型里用 叠加层(Overlays) 弹出了一个假键盘,结果却发现当键盘盖在屏幕下半截时,用户想往下滑看被盖住的表单,或者想点击屏幕上半截的另一个输入框,全部被 Overlay 的全屏透明蒙层卡死了!

按以下标准步骤即可彻底解决“弹键盘后底层页面动不了”的僵局:

第 1 步:分离“键盘层容器”与“可滚动表单主体” #

  1. 确保业务页面的表单内容区已包裹在启用了 Vertical scrolling 的中层 Frame(命名为 Form_Scroll_Container)中,且页面底部的空白内边距(Bottom Padding)预留至少 350px(相当于提前留出软键盘高度的缓冲垫,避免滚到底时最后一行输入框还是滚不上来!)。
  2. 如果你需要在页面下方放一个跟着键盘走的操作条(例如“完成 / 下一步”辅助栏),不要把它焊死在 Form_Scroll_Container 外部的固定底边,而是直接将该操作条作为键盘组件顶部的原生 Accessory Bar(键盘附着工具栏),与虚拟键盘一起打成同一个组合组件 Component_Keyboard_With_CTA。

第 2 步:双动作链同时实现“弹出键盘 + 自动推顶聚焦框” #

  1. 选中靠下的目标输入框(例如 Input_Address_Detail),在 Prototype 面板点击 + 添加第一条动作:
    • Trigger:On tap
    • Action:Open overlay -> 选择 Component_Keyboard_With_CTA
    • Overlay 位置设为 Bottom center,动画选 Move in(方向向上 ↑,Ease out,250ms)。
    • 极其关键的防卡死开关:不要勾选 Add background(无须变暗遮罩),若希望点击键盘外收起,勾选 Close when clicking outside;若希望用户在键盘弹出时依然能上下滚动表单或直接切点上方输入框,则采用**“页面内嵌状态切换”方案(见下文实操二)**替代 Overlay 遮罩。
  2. 在同一条 On tap 触发器下点击 + 追加第二条动作(Scroll to 详解见 原型滚动行为与视口锚点实战):
    • Action:Scroll to -> 目标选中当前这个 Input_Address_Detail 输入框(或它正上方关联的表单字段标题 Label_Address);
    • Offset Y 填入 -120:这样输入框会自动平滑滚动到距离屏幕顶部 120px 的黄金视线区,把底部 340px 空间完整腾给弹出来的软键盘。

三、实操二:用 Variables + Auto Layout 打造随键盘同步上浮的 IM / AI 聊天框 #

对于微信聊天、AI 对话助理或评论回复弹窗这类“输入框本来就在屏幕最底部”的页面,不能只靠页面滚动,必须让底部的吸底输入栏被键盘整体向上顶起。用 Variables 驱动比单纯叠 Overlay 更拟真、且不阻挡任何消息列表滑动:

  1. 创建布尔变量控制键盘显隐:在 Variables 变量面板 中新建一个 Boolean 变量 isKeyboardOpen(默认 false),再新建键盘高度占位容器 _Keyboard_Spacer_Box。
  2. 用垂直 Auto Layout 拼装整页结构(自上而下 3 段式):
    • 顶层 Screen_Chat(固定手机高度如 844px,开启垂直 Auto layout,间距 0):
      1. Top_Nav_Bar:固定高度 98px(含状态栏);
      2. Chat_Message_List:垂直高度设为 Fill container,开启 Clip content 与 Vertical scrolling;
      3. Bottom_Input_Bar:默认自带 Bottom Padding: 34px(兜底安全区),或者内置两个变体(Idle 含 34px 底部留白,Active 底部留白缩为 8px);
      4. Keyboard_Wrapper:高度包住 310px 键盘实体,并将该图层右侧眼睛图标的 Visibility(可见性)直接绑定变量 isKeyboardOpen!
  3. 验证神奇的物理挤压效果:
    • 在原型中点击 Bottom_Input_Bar 时执行 Set variable: isKeyboardOpen = true(可搭配页面级文本输入模拟方案,详见 原型模拟真实打字与文本输入实战);
    • 瞬间 Keyboard_Wrapper 现身占据底部 310px,Bottom_Input_Bar 被严丝合缝地向上抬起且不再多出 34px 双重白边,而中部的 Chat_Message_List 因为设为 Fill container 会自动压缩剩余高度并保持消息流完全可滑动!点击聊天列表空白区执行 Set variable: isKeyboardOpen = false 即可丝滑收起键盘。

四、向 Dev Mode 交付与移动端键盘遮挡高频排查表 #

在进入 Dev Mode(开发模式) 向客户端与前端交付时,务必同步明确以下 4 类高频避坑规则(安全区基础标注另见 移动端触摸热区与 Safe Area 实战,全站排障见 Figma 常见报错与疑难故障诊断手册):

异常现象或交付争议 底层原因定位 标准化排查与工程交付修复方案
真机上线后,底部输入栏与系统键盘上沿之间多出一块 34pt 的空白断层 研发同时保留了底部 SafeArea 固定 34pt 内边距与键盘高度推顶偏移量,产生了双倍底部安全区叠加 在 Dev Mode 批注明确写出:键盘收起时 bottom-padding = 34pt(SafeArea);键盘弹起时 bottom-padding 归 0,紧贴键盘顶边(Android Jetpack Compose 使用 Modifier.imePadding() 配合 navigationBarsPadding() 自动互斥处理)
在 Figma 原型里用 Open Overlay 弹出软键盘后,想点击上方另一个输入框切焦点,点一下反而只关闭了键盘没切过去 Close when clicking outside 默认拦截了第一次点击事件仅用于关闭 Overlay,消费掉了底层输入框的 On tap 触发 改用本文实操二的 Variables 布尔变量驱动容器显隐(非 Overlay 模态层),即可在键盘展开期间任意点击切换上方输入框或滑动消息列表
iOS Safari 打开 H5 表单页,点击输入时整个网页头部导航被顶出屏幕外 CSS 使用了固定 100vh 布局且未响应动态视口,浏览器在聚焦输入框时强行滚动整个文档流 交付前端建议:整页容器改用 height: 100dvh(或监听 window.visualViewport.resize 动态调整底部固定栏 transform),避免使用旧版 100vh
Figma 长表单点击下方输入框执行 Scroll to 后,页面根本没往上滚,输入框还是被键盘挡住 Form_Scroll_Container 底部没有预留足够的底部留白(Bottom Padding),导致容器已经滑到底部极限,物理上无法继续上移 给滚动容器底部增加 ≥ 350px 的 Bottom Padding(或仅在 isKeyboardOpen == true 时展开底部透明占位垫块),确保末行表单有足够空间滚入上半屏

❓ 常见问题与答疑 (FAQ)

高频疑难解析与避坑指南
A

完全不需要。绝大多数核心功能在免费 Starter 计划中均可完整体验与实操练习,无需额外付费购买付费团队版。