fix: 修正 H5 按钮高度令牌不生效

共享按钮令牌声明在 app.css 的 page 选择器里,而 H5 渲染树没有 page 元素,导致
var(--brand-button-height) 解析失败、min-height 退化成 auto:H5 预览按钮实际高 38px
(内容撑开),与小程序 88rpx(375px 视口等于 44px)不一致,也违反模板完成度规则的
双端 reset 一致要求。

- 令牌改为同时声明在 page 与 body 上,值仍只写一次;微信端取 page,H5 取 body;
- 新增浏览器守卫,断言首页按钮 min-height 解析为 44px 且实际高度一致;
- 在模板完成度规则中记录该根因,避免声明被挪回单一 page 选择器。

验证:weapp 产物输出 page,body{--brand-button-height:88rpx},H5 输出 page,body{2.2rem};
浏览器实测 375px 视口下 min-height/height 均为 44px,430px 视口为 50.45px,与小程序
rpx 缩放一致;把声明改回 page-only 后守卫按预期失败(Received: "auto"),恢复后 12 项
浏览器回归全部通过;六类产物指纹残留为 0;format、lint、typecheck 通过。
This commit is contained in:
que01 committed 2026-10-13 23:44:12 +08:00
1 parent 29e5666d74
commit bb94d80e13
3 files changed
+20

No files matched your search

+2
View File
@@ -74,6 +74,8 @@ Taro 小程序构建默认会把 CSS 中的 HTML 标签选择器重写为 `.h5-<
共享 reset 必须让微信 `<button>` 与 Taro H5 的 `taro-button-core` 一致:默认 flex、全宽、`min-height:var(--brand-button-height)`、文字居中,并重置 `appearance`、间距、边框和背景。局部按钮通过 `--brand-button-height` 或结构化 class 调整;模板样式不得复制基础尺寸,也不得重新声明整套居中规则。
共享令牌必须同时声明在 `page` 与 `body` 上(见 `apps/taro/src/app.css`):微信端根元素是 `page`,H5 渲染树里没有 `page` 元素,只写 `page` 会让 H5 的 `var(--brand-button-height)` 解析失败并退化成 `auto`。两端默认 88rpx(H5 在 375px 视口等于 44px)由浏览器测试守卫,不要把这组声明挪回单一 `page` 选择器。
## Taro 双端验收清单
小程序视觉回归按页面角色和原生控件执行,不按模板名写专用清单。平台新增或修改原生控件时,先更新共享 reset、令牌和产物契约测试,再让所有模板自动受益。每个模板变更至少记录一次: