finesse-skill移动端H5页面完全指南:390×844框架、安全区与拇指区法则

原创2026-10-27 11:28:091,708 阅读

finesse-skill移动端H5页面完全指南:390×844框架、安全区与拇指区法则

finesse-skill 是一款给 AI 编码助手用的设计技能,其中的 h5 路线专攻移动端 H5 页面:先锁定 390×844 的手机框架,再用安全区计算和拇指区法则决定内容与按钮的落位,让页面在刘海屏上不被遮挡、主按钮正好落在拇指够得到的地方。

finesse-skill项目封面:品牌落地页与产品仪表台示例,与移动端H5页面同源的界面设计技能

一、30秒判断:这页该不该按 H5 来做

新手最常踩的坑,是把「做个手机端页面」当成一种需求——其实它是两种完全不同的活:

这个页面只在手机上打开,还是电脑上也要好看?

你的回答 该走的路线 做什么
只在手机上打开(H5、活动页、小程序页、app 原型) h5 路线 搭手机框架、单列布局、OS 家具(状态栏 / TabBar / 底部指示条)
电脑和手机都要好看 brand / product 路线 + 移动地板 做真正的响应式页面,不要套手机框

h5 是一条「容器路线」:它负责钉死框架和触摸规则,内容语法仍从其他路线借用——移动商详 = h5 + commerce,app 屏幕 = h5 + product。也就是说 H5 页面不是"缩小版网页",而是手机形态下的另一种页面。

二、390×844 固定框架:为什么 body 不滚动

桌面页面的视口是一个"区间"(320→1920,靠断点重排);H5 的视口是一个固定的 390×844 矩形,桌面反而是降级形态。整套骨架只有四层:

  1. body —— 锁死,永不滚动。 这是与所有其他路线完全相反的架构反转;
  2. .phone —— 视口。 真机上边到边;桌面 ≥560px 时自动变成一台带边框、投影的手机(整页唯一的响应式规则);
  3. .status —— 自画的状态栏。 时钟要取真实时间,写死的 9:41 会一眼被认成截图;
  4. #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——同一物种,只有框架不同:

RELAY订单异常处理工作台桌面形态:三栏布局的运行流与审批卡,对应手机上的H5每日工作台形态

而"内容从哪来"看这张图就明白了:这是 product 路线的宠物健康仪表台,它展示的内容语法(状态卡、图表、照片热点标注)完全可以被 h5 框架包装进手机里:

PawCare+宠物健康仪表台:状态卡、心率曲线与照片热点标注,可被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 里),你也可以照着验收:

  1. 刘海测试:状态栏、底栏、sheet、#app 底 padding 四处都有 env();
  2. 画框测试:≥560px 是"背景上的一台手机",<560px 边到边、无残留画框 CSS;
  3. 滚动测试:body 不滚、#app 滚、无可见滚动条、最后一行内容不被底栏压住;
  4. 触摸测试:所有可点元素 ≥44px、有 :active、无灰色闪光;
  5. 高度测试:640px 的 SE 级小屏不截断;
  6. reduced-motion 测试:环境动效层要移除而不是冻住(冻住的雨像一张条纹截图);
  7. 对比度测试:文字压在图上时,每个场景状态都要能读;
  8. 家具测试:状态栏时钟是真实的、TabBar 激活态是实心形状、sheet 有抓手把手。

八、值得读的文件

想深入,直接读这些文件(都是相对仓库根目录的路径):

记住三句话就够了:框架先于一切(390×844 固定矩形);env() 必须出现(否则刘海屏全坏);主按钮沉底(拇指区法则)。做到这三条,你的 H5 页面就跨过了"像网页"的门槛。

登录后查看全文
finesse-skill