finesse-skill移动端H5页面完全指南:390×844框架、安全区与拇指区法则
finesse-skill移动端H5页面完全指南:390×844框架、安全区与拇指区法则
finesse-skill 是一款给 AI 编码助手用的设计技能,其中的 h5 路线专攻移动端 H5 页面:先锁定 390×844 的手机框架,再用安全区计算和拇指区法则决定内容与按钮的落位,让页面在刘海屏上不被遮挡、主按钮正好落在拇指够得到的地方。
一、30秒判断:这页该不该按 H5 来做
新手最常踩的坑,是把「做个手机端页面」当成一种需求——其实它是两种完全不同的活:
这个页面只在手机上打开,还是电脑上也要好看?
| 你的回答 | 该走的路线 | 做什么 |
|---|---|---|
| 只在手机上打开(H5、活动页、小程序页、app 原型) | h5 路线 | 搭手机框架、单列布局、OS 家具(状态栏 / TabBar / 底部指示条) |
| 电脑和手机都要好看 | brand / product 路线 + 移动地板 | 做真正的响应式页面,不要套手机框 |
h5 是一条「容器路线」:它负责钉死框架和触摸规则,内容语法仍从其他路线借用——移动商详 = h5 + commerce,app 屏幕 = h5 + product。也就是说 H5 页面不是"缩小版网页",而是手机形态下的另一种页面。
二、390×844 固定框架:为什么 body 不滚动
桌面页面的视口是一个"区间"(320→1920,靠断点重排);H5 的视口是一个固定的 390×844 矩形,桌面反而是降级形态。整套骨架只有四层:
body—— 锁死,永不滚动。 这是与所有其他路线完全相反的架构反转;.phone—— 视口。 真机上边到边;桌面 ≥560px 时自动变成一台带边框、投影的手机(整页唯一的响应式规则);.status—— 自画的状态栏。 时钟要取真实时间,写死的9:41会一眼被认成截图;#app—— 唯一的滚动容器,TabBar、底部 sheet 全部用绝对定位浮在滚动层之上。
页面里最关键的 meta 契约只有一行:
<meta name="viewport" content="width=device-width, initial-scale=1,
viewport-fit=cover, maximum-scale=1, user-scalable=no">
其中 viewport-fit=cover 是让 env(safe-area-inset-*) 返回真实数值的开关——没有它,下面所有安全区数学会静默失效,内容直接躺在刘海下面。
⚠️ 唯一例外:纯长文阅读页应去掉
user-scalable=no,把双指缩放还给需要它的读者。
三、安全区计算:内容被刘海挡住的最常见原因
H5 第一大缺陷是"整个文件里一个 env() 都没有"——页面在所有刘海手机上都是坏的,但你在桌面画框里完全看不出来。规则很简单:
- 所有
env()都包进calc()。 桌面和画框里这些值是0px,calc()自动降级,不用写任何额外规则:
#app { padding-bottom: calc(env(safe-area-inset-bottom) + 108px); }
.tabbar{ bottom: calc(env(safe-area-inset-bottom) + 16px); }
.status{ height: calc(env(safe-area-inset-top) + 44px); }
#app的底内边距 = 底部栏高度 + 安全区 inset(62px 悬浮 TabBar 对应 108px),否则最后一行内容永远藏在 TabBar 下面;- 横向滚动条要"逃出去":用负 margin 抵消页面左右 padding,首尾两张卡才不会显得被裁掉。
四、拇指区法则:主按钮全部沉底
在 844px 高的屏幕上,拇指舒适够到的范围大约是底部 55%。这条规则直接反转了桌面版式里的优先级:
| 位置 | 角色 | 说明 |
|---|---|---|
| 📍 底部 | 主操作 | TabBar、购买栏、FAB、sheet 的确认按钮一律放这里 |
| 顶部 | 只展示 | 标题、大数字、封面图。左上角返回键是唯一例外(肌肉记忆大于够得着) |
| 右上角 | 最够不到的像素 | 永远不要放"提交" |
配套还有:顶部不是不能交互,而是"展示优先";真正需要用户"完成"的动作,必须落在拇指区。
五、六种手机形态:先选形态,再谈风格
h5 页面按"这页在干什么"分成六种结构完全不同的形态,混用两种才会做出像网站的怪页面:
| 形态 | 适合 | 一句话记忆 |
|---|---|---|
| A · app 壳 | tab、列表、详情、设置 | 浮动胶囊 TabBar + 上滑 sheet,像真 app |
| A.1 · 每日工作台 | 记账、打卡、喂宠、写日记 | 围着"他自己反复做的一件事"转,必须有性格 |
| B · 翻页 deck | 活动页、营销 H5 | 一屏一个信息,滑页推进 |
| C · snap 叙事 | 数据报告、年度回顾 | 真滚动 + scroll-snap,比 deck 更稳 |
| D · 商详堆栈 | 移动端商品详情 PDP | 图集→价格→SKU sheet→吸底购买栏,顺序几乎固定 |
| E · 长文站点 | 手机官网 | 唯一允许 .phone 整页滚动的形态 |
| F · 沉浸单屏 | 天气、海报 | 满屏场景图 + 超大细字重数字 + 白色底部抽屉 |
工作台是其中最有意思的一种:它有"两副身体"。电脑上开时用 product 壳,手机上开时用形态 A.1——同一物种,只有框架不同:
而"内容从哪来"看这张图就明白了:这是 product 路线的宠物健康仪表台,它展示的内容语法(状态卡、图表、照片热点标注)完全可以被 h5 框架包装进手机里:
六、触摸法则:44px 热区与 :active 反馈
桌面有 hover,手机上没有。这几条没有桌面等价物的规则决定了"像不像 app":
- 44×44px 是点击热区下限,不是视觉尺寸——21px 的图标要住进 46px 的按钮里;
:active是你唯一免费的按反馈,按下去要有scale(.96)之类的变化,否则按钮在手机上"像死的";-webkit-tap-highlight-color: transparent干掉每次点击的灰色闪光——不删,一眼就是"网页套壳";- 手势用 Pointer Events,
pointercancel必须处理(中断的拖拽不能把元素卡在半空); - 8px 才起拖,约 50px 才确认,没到确认阈值就弹回原位,永远不留半开状态。
七、起飞前自检:8 道 H5 专属闸门
finesse 交付前会自动跑一遍这套闸门(在 h5-mobile.md 的 §10 里),你也可以照着验收:
- 刘海测试:状态栏、底栏、sheet、
#app底 padding 四处都有env(); - 画框测试:≥560px 是"背景上的一台手机",<560px 边到边、无残留画框 CSS;
- 滚动测试:
body不滚、#app滚、无可见滚动条、最后一行内容不被底栏压住; - 触摸测试:所有可点元素 ≥44px、有
:active、无灰色闪光; - 高度测试:640px 的 SE 级小屏不截断;
- reduced-motion 测试:环境动效层要移除而不是冻住(冻住的雨像一张条纹截图);
- 对比度测试:文字压在图上时,每个场景状态都要能读;
- 家具测试:状态栏时钟是真实的、TabBar 激活态是实心形状、sheet 有抓手把手。
八、值得读的文件
想深入,直接读这些文件(都是相对仓库根目录的路径):
- 📱 H5 全套规则:h5-mobile.md —— 视口契约、安全区数学、拇指区、六种形态、原生家具配方、自检闸门
- 🧱 桌面页不坏掉的六条硬地板:mobile-floor.md
- 🛒 移动商详的内容规则:commerce-ui.md
- 📂 四个打开就能跑的 H5 示例:h5-pawpal-app-shell.html、h5-fern-meal-desk.html、h5-peach-daily-desk.html、h5-brew-mobile-pdp.html
- 📖 示例索引与学习要点:EXAMPLES.md
- 🔍 本地缺陷检测器:detect.mjs,USAGE.md 里则有给零基础用户的完整使用清单
记住三句话就够了:框架先于一切(390×844 固定矩形);env() 必须出现(否则刘海屏全坏);主按钮沉底(拇指区法则)。做到这三条,你的 H5 页面就跨过了"像网页"的门槛。


