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

+4
View File
@@ -1,5 +1,9 @@
page {
background: #fafaf9;
}
/* H5 渲染树里没有 page 元素,令牌必须同时声明在真实根节点 body 上,双端按钮高度才一致。 */
page,
body {
--brand-button-height: 88px;
--brand-button-compact-height: 46px;
}
+14
View File
@@ -3,6 +3,20 @@ import { test, expect } from "@playwright/test";
// 产物会遮蔽 Taro 运行时命名,选择器同时接受源码名称与遮蔽名称。
const BUTTON_CORE = ":is(taro-button-core, appkit-button-core)";
const TABBAR = ":is(.taro-tabbar__tabbar, .appkit-tabbar__tabbar)";
test("共享按钮令牌在 H5 生效并与小程序高度一致", async ({ page }) => {
await page.setViewportSize({ width: 375, height: 812 });
await page.goto("/");
const measured = await page
.locator(`.food-home .actions ${BUTTON_CORE}`)
.first()
.evaluate((element) => ({
minHeight: getComputedStyle(element).minHeight,
height: element.getBoundingClientRect().height,
}));
// 750 设计宽度下 88rpx 在 375px 视口等于 44px;H5 若取不到令牌会退化成 auto。
expect(measured.minHeight).toBe("44px");
expect(measured.height).toBe(44);
});
test("真实 API 驱动首页、出摊和主理人视觉槽位", async ({ page }) => {
const errors: string[] = [];
page.on("pageerror", (error) => errors.push(error.message));
+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、令牌和产物契约测试,再让所有模板自动受益。每个模板变更至少记录一次: