Figma 移动端动态视口(dvh / svh / lvh)、刘海安全区(Safe Area)与 CSS Scroll Snap 滚动捕捉交付实战:告别 100vh 底部遮挡、地址栏跳动与横向画廊卡顿
做移动端 H5 或响应式 Web 应用的设计师与前端工程师,几乎都踩过同一个“玄学坑”:在 Figma 中明明使用标准 390 × 844 画板将底部主按钮(CTA)和悬浮 Tab Bar 贴底对齐,在电脑浏览器模拟器里也一切正常;可一旦发到 iPhone Safari、Android Chrome 或微信内置浏览器真机打开,底部“立即下单 / 下一步”按钮就被浏览器底部的地址栏死死盖住一半,或者在页面刚开始滑动、地址栏收起的瞬间,整页卡片突然往下窜跳几十像素。
造成这一偏差的根源有两个:第一,传统 CSS 的 100vh 按浏览器“地址栏已收起时的最大高度”计算,导致首屏刚打开、地址栏还处于展开状态时,页面实际高度溢出了可视区;第二,在 Figma 里用 Horizontal scrolling 做的横向商品轮播与卡片流,前端如果盲目引入重型 JS 轮播库,不仅包体积膨胀,还极易出现手势冲突与惯性滑动卡顿。把 Figma 的 Constraints 约束、Auto Layout 自动布局 与现代 CSS 动态视口单位(dvh / svh / lvh)、Safe Area 安全区环境变量及 CSS Scroll Snap 对齐,才能实现零 JS 依赖的真机级稳定还原。
一、移动端视口单位选型对比:vh vs svh vs lvh vs dvh #
现代移动端浏览器的地址栏和底部工具栏会随用户上下滑动而动态展开或收起。CSS Viewport Units 4 标准将模糊的 vh 拆分为了三种确定语义(关于更多手机物理与逻辑分辨率数据,可查阅 UI 设计规范与主流设备尺寸速查表):
| 视口单位 | 英文全称与计算基准 | 随浏览器地址栏伸缩是否变化 | 核心优点与潜在副作用 | 最佳业务适用场景 |
|---|---|---|---|---|
vh(传统) | Viewport Height(浏览器默认按最大高度估算) | 不变化(首屏常溢出屏幕) | 兼容远古浏览器,但首屏展开工具栏时底部固定栏必被遮挡 | 仅作降级兜底写法(如先写 100vh 再用 100dvh 覆盖) |
svh(最小视口) | Small Viewport Height(地址栏全部展开时的最小可见高) | 不变化(绝对稳固零重排) | 首屏 100% 不被遮挡、滑动过程零抖动;缺点是工具栏收起后下方会留白或需滚动 | 全屏落地页首屏 Hero、登录页、弹窗全屏蒙层、固定底部表单页 |
lvh(最大视口) | Large Viewport Height(地址栏完全收起时的最大可见高) | 不变化 | 保证视觉背景图铺满最大屏幕空间,不会在地址栏收起时露底 | 全屏沉浸式渐变底图、视频背景层(禁止把核心按钮放底部) |
dvh(动态视口) | Dynamic Viewport Height(随工具栏收放实时重算) | 实时变化 | 无论工具栏展开还是收起,始终严丝合缝贴合当前可见视口;但长列表滚动时触发高度重绘可能造成轻微帧抖 | App Shell 独立滚动应用框架、聊天对话界面、全屏编辑器 |
选型口诀:“静用
svh保首屏不遮挡、动用dvh做单页 App Shell、背景用lvh防露白”。切忌在带长页面垂直滚动的内容流中盲目给大背景图或广告卡片写height: 100dvh,否则手指一滑,工具栏伸缩就会把卡片瞬间拉长或压扁。
二、实操一:在 Figma 中规范移动端安全区与动态高度画板 #
要让前端工程师在 Dev Mode(开发模式) 里一眼读懂“哪里是系统安全区、哪里是动态视口弹性区”,设计师需要在组件和画板阶段建立三道防线:
1. 拆分“视觉主体 + 底部安全区占位”的双层底部栏 #
在 iPhone 全面屏及部分手势导航 Android 机型上,屏幕底部有 34pt(约 34px) 的 Home Indicator 横条安全区;横屏或带圆角的屏幕左右两侧也有安全边界。
- 在 Figma 创建底部操作坞组件(如
Bottom_Action_Bar)时,不要把底部留白直接写死成一个巨大的padding-bottom: 50px。 - 正确结构是构建两层纵向 Auto Layout:
- 内容层(
Action_Content):高度Fixed或Hug,上下内边距保持统一规范(如12px 16px),内部放主按钮; - 安全区占位槽(
SafeArea_Bottom_Inset):单独命名为SafeArea / HomeIndicator,在移动端基准画板中设高度为34px(纯展示辅助或半透明背景延续),并在 Dev Mode 注释中写明:padding-bottom: max(16px, env(safe-area-inset-bottom))。
- 内容层(
- 这样在老款非全面屏手机(
safe-area-inset-bottom = 0px)或桌面 Web 端下,操作栏依然保留舒适的16px下边距,而不会多出难看的34px空洞。
2. 用 Constraints 与最小高度校验“短屏 / 键盘弹起”容灾 #
在浏览器工具栏展开的 svh 状态下,390 × 844 的 iPhone 实际可用网页高度往往只有 663px ~ 710px,而非 844px:
- 复制一份主流程页面 Frame,将高度临时压低到
660px,检查中间表单或卡片区是否设置了Vertical scrolling(垂直滚动),还是被写死的间距直接顶出了画板下沿。 - 底部悬浮按钮外层 Frame 务必设置水平
Left and right、垂直Bottom约束,并在页面主内容区最后一项预留等同于底部栏高度的底部缓冲空间(Padding Bottom),防止滚动到底时最后一行文字被悬浮按钮永久盖住。
三、实操二:Figma 横滑原型映射零 JS CSS Scroll Snap 画廊 #
在电商商品推荐、SaaS 引导卡片与横向标签选项卡中,设计师常在 Figma 中按照 滚动溢出原型指南 为外框开启 Overflow: Horizontal scrolling 与 Clip content。为了让网页和 H5 同样拥有丝滑的“逐张吸附停靠”手感,只需在 Dev Mode 中向前端交付 CSS Scroll Snap 契约,完全省去 Swiper 等重型 JS 依赖。
1. Figma 画板容器的三个关键对齐参数 #
为了让 CSS 直接读取 Auto Layout 数值,Figma 横向滑动区必须严格符合以下结构:
- 外层视口 Frame (
Carousel_Viewport):宽度Fill container(撑满屏幕宽390px),开启Clip content,水平滚动溢出设为Horizontal。 - 左右留白与卡片间距(
Padding&Gap):左右内边距设为页面标准边距(如16px),卡片之间Gap设为12px;切勿把多余空白直接画在最外层大 Frame 外面充当隐藏占位,确保右侧下一张卡片刚好露出24px ~ 36px作为“可继续横滑”的视觉暗示(Peek Affordance)。 - 在 Dev Mode 标注对齐点:明确写明吸附方向(强制单张对齐还是自由顺滑停靠)以及每张卡片停靠位置(左对齐贴边还是屏幕居中)。
2. 生产级移动端视口 + 安全区 + Scroll Snap 完整交付代码 #
<!-- 1. HTML head 必须开启 viewport-fit=cover 才能激活刘海屏 env() 安全区变量;
interactive-widget=resizes-content 让 Chrome Android 软键盘弹起时自动压缩视口而非顶飞顶部栏 -->
<meta
name="viewport"
content="width=device-width, initial-scale=1.0, viewport-fit=cover, interactive-widget=resizes-content"
/>
/* 2. 全屏 App Shell 页面:vh 兜底 + dvh 精确动态贴合,杜绝地址栏遮挡底部 CTA */
.mobile-app-shell {
display: flex;
flex-direction: column;
height: 100vh; /* 兼容旧设备兜底 */
height: 100dvh; /* 动态跟随地址栏伸缩,始终紧贴当前可见区域 */
overflow: hidden;
padding-top: env(safe-area-inset-top);
}
/* 如果是营销落地页首屏 Hero,追求滚动不重绘跳动,改用 svh */
.landing-hero {
min-height: 100vh;
min-height: 100svh; /* 地址栏完全展开时的最小视口高,保证主按钮首屏必现 */
}
/* 顶部与底部固定栏适配刘海/灵动岛与底部 Home 横条 */
.mobile-bottom-cta {
flex-shrink: 0;
padding: 12px 16px max(12px, env(safe-area-inset-bottom));
background-color: var(--ds-surface-elevated);
border-top: 1px solid var(--ds-border-subtle);
}
/* 3. 零 JS 横向滚动捕捉画廊(1:1 映射 Figma Auto Layout Gap & Padding) */
.figma-snap-carousel {
display: flex;
gap: 12px;
padding-inline: 16px;
overflow-x: auto;
overflow-y: hidden;
/* mandatory:松手必吸附到最近卡片;proximity:靠近捕捉点才轻柔吸附 */
scroll-snap-type: x mandatory;
/* 滚动吸附停靠时自动保留 16px 左侧安全边距,避免卡片贴死屏幕边缘 */
scroll-padding-inline: 16px;
/* 防止横向滑到尽头后误触发浏览器“左滑返回上一页”手势 */
overscroll-behavior-x: contain;
-webkit-overflow-scrolling: touch;
scrollbar-width: none; /* 隐藏原生丑陋横向滚动条 */
}
.figma-snap-carousel::-webkit-scrollbar {
display: none;
}
.figma-snap-card {
flex: 0 0 82%; /* 露出右侧下一张卡片边缘,形成强滑动暗示 */
scroll-snap-align: start;
/* 可选:快速狠滑时强制每次最多翻过一张卡片,防止一下滑飞五六张 */
scroll-snap-stop: always;
}
横竖屏延伸校验:当手机旋转为横屏时,
100dvh会骤降至360px左右,左右两侧也会出现灵动岛安全区遮挡,需要配合env(safe-area-inset-left)与env(safe-area-inset-right)。完整横竖屏双态适配策略可参考 Figma 横竖屏切换与屏幕旋转自适应实战。
四、移动端动态视口、安全区与横向滚动高频排障表 #
上线前建议使用 Figma 与 Chrome DevTools 联合像素级设计走查 与真机调试对照排查以下经典问题(更多通用排障见 常见报错与疑难故障诊断手册):
| 真机异常现象 | 根本原因剖析 | 标准化修复方案 |
|---|---|---|
写了 env(safe-area-inset-bottom) 但在 iPhone 上依然返回 0px | HTML <meta name="viewport"> 漏掉了 viewport-fit=cover | 在 <meta name="viewport"> 中补全 viewport-fit=cover,浏览器才会解锁刘海与底部横条真实安全距离 |
长文章页中放了一块 100dvh 的卡片,手指上下滑动时卡片一顿一顿地闪跳 | 地址栏随滑动收放,dvh 实时重算高度引起全页回流(Reflow) | 凡是不需要随地址栏实时贴底的独立区块,统一改用静态的 100svh 锁定首屏高度 |
| Scroll Snap 第一张卡片停靠位置正常,第二张起左边缘总是贴死屏幕最左边 | 开发者只写了 padding-inline: 16px,忘记写 scroll-padding-inline: 16px | 给横向滚动容器补上 scroll-padding-inline: 16px,使吸附边界与画布内边距保持一致 |
| 用户在横滑卡片时手指往左一滑,直接触发了 Safari/微信“返回上一页” | 容器未隔离水平边缘手势传播,滑到第一张尽头后冒泡到浏览器历史手势 | 在滚动容器上增加 overscroll-behavior-x: contain;,阻断水平越界手势穿透 |
| Android 浏览器点击底部输入框弹出软键盘时,顶部固定导航栏被顶出屏幕 | 默认视口高度未随虚拟键盘收缩,聚焦输入强行滚动整页文档 | 设置 interactive-widget=resizes-content,或将顶部导航纳入独立滚动外层 100dvh 弹性布局(另见 后台 App Shell 独立滚动实战) |
核心手册与速查工具
高频手册与实用设计生产力工具直达常见问题与答疑 (FAQ)
高频疑难解析与避坑指南完全不需要。绝大多数核心功能在免费 Starter 计划中均可完整体验与实操练习,无需额外付费购买付费团队版。