2026 远程 Mac 前端发布验收:
CSS Subgrid 与嵌套 Grid 在 Safari 与 Chromium 的布局差异对照表及渐进增强三步清单
面向双引擎发布签字:父级网格被子卡片「借轨」后,gap、命名线、溢出与书写模式任一组合都能在 Linux CI 的 Chromium 里假绿,却在苹果系露馅。下面用对照表固定观察面,用渐进增强三步闸收口,并给出Playwright WebKit可落地的断言思路。内链 Playwright 与远程 Mac、容器查询与 @layer、层叠与 :has;站点 首页、算力资费、帮助、购买。
01 为何 nested Grid + subgrid 要单独开一张发布单
grid-template-rows: subgrid / grid-template-columns: subgrid 让子元素沿用父轨,营销页里常见的「主栏 + 多卡片区」一旦子卡片内部再切列,很容易出现轨数、gap 百分比参照、命名线继承与外层 min-height、overflow 的耦合。Chromium 在无头或窄 CI 里往往先过;Safari 在真 WebKit与苹果 GPU 合成路径上,滚动条、direction: rtl 与 writing-mode 组合更容易暴露 1~2px 级的对齐漂移。因此签字矩阵里应把「同 URL、同视口、同构建」写死,并与 content-visibility 长列表、顶层模态等文交叉执行,避免浮层盖住子网对齐线。
02 Safari 与 Chromium 布局差异对照表(签字用)
下表不是「谁对谁错」,而是你要采什么证据:每一行在合并前都应有 fixture 截图或脚本几何值。若与 ESM 与 Import Maps 同页,请顺带锁模块加载时序,避免布局脚本晚到导致假失败。
| 考查面 | Safari(WebKit) | Chromium(Blink) | 签字动作 |
|---|---|---|---|
| subgrid 轴声明 | 行轴/列轴可分别 subgrid;命名线从父网透传,注意区名拼写与重复。 | 同规范路径;DevTools Grid 叠层便于肉眼看轨。 | 各引擎导出一张同宽带 Grid 覆盖层的截图;附 grid-column / grid-row 文本。 |
gap 与百分比轨 |
嵌套语境下百分比 gap 的参照盒与父轨对齐强相关。 | 应对照同一 fixture;勿凭「本地 Chrome 一眼过」。 | fixture 锁容器宽度;记录 column-gap / row-gap 计算像素。 |
| 溢出与滚动 | 子项 overflow: auto 与父 min-height: auto 组合时,滚动高度与轨外扩需手拖验证。 |
行为应对齐;若分叉,优先查是否误用隐式轨或混合对齐。 | 录短视频:纵向滚动到底,看卡片区是否压线或露底。 |
| RTL / 竖排 | direction: rtl 与 writing-mode: vertical-rl 下轨向互换,子列对齐要单独一组。 |
同样必须跑;不要只测 LTR 横排。 | 远程 Mac 上各保存一组截图文件名带 rtl / vrl 后缀。 |
| 与容器查询同屏 | @container 宽度变化会触发子网重算,易出现「窄屏刚好、宽屏裂轨」。 |
同步观察;结合 容器查询文 的层叠段落。 | resize 手测 + 至少一个断点的几何表。 |
03 渐进增强三步验收清单
- 第一步:基线可交付。在探测失败或业务需支持旧版 WebKit 时,父级用显式
grid-template-*或分区 flex 仍能完成信息架构与主按钮区;发布说明写清「无 subgrid 时的视觉差」与可接受范围。 - 第二步:能力分支内冻结契约。仅当
@supports (grid-template-columns: subgrid)(或行轴等价)为真时启用子网;区名、span、gap与 rtl 组合写入静态 fixture,禁止合并前临时改轨数。 - 第三步:双引擎闸口。同一预发 URL、同一构建号、同一视口,在 Safari 与 Chromium 各留证据:几何 CSV、截图或 10 秒内短视频;与 Playwright 远程流水线 的工件互相引用工单号。
若删掉 subgrid 一行 CSS,页面是否仍可用且不崩主流程?否,则回退到第一步再合。
04 可执行测试用例思路(Playwright / WebKit)
思路是「几何优先」:像素级断言比截图 diff 更稳,但真机仍要补一层。项目里可用 pnpm exec playwright test --project=webkit 等在远程 Mac 上跑;内核与桌面 Safari 仍有差,故步骤三里保留真机条。
- 用
page.evaluate调CSS.supports('(grid-template-columns: subgrid)'),无支持则跳过子网断言、改验基线选择器。 - 对子卡片内关键单元格执行
getBoundingClientRect(),断言相邻列左缘间距等于父级column-gap与轨宽公式(先算期望值再toBeCloseTo)。 page.setViewportSize扫 375 / 768 / 1280 三档,防止容器查询 + subgrid 只在单档成立。- 同一用例注册
chromium与webkit两套 project,失败时附带test.info().attach打 JSON 轨数据。
// 思路示例:fixture 中 .parent / .child 已标好 data-testid
import { test, expect } from '@playwright/test';
test('subgrid column gap aligns with parent', async ({ page }) => {
await page.goto(process.env.FIXTURE_URL!);
const sub = await page.evaluate(() =>
CSS.supports('(grid-template-columns: subgrid)')
);
test.skip(!sub, 'engine without subgrid');
await page.setViewportSize({ width: 960, height: 720 });
const [a, b] = await page.$$eval('[data-cell]', (els) =>
els.slice(0, 2).map((e) => e.getBoundingClientRect().left)
);
const gap = await page.$eval('.parent', (el) =>
parseFloat(getComputedStyle(el).columnGap)
);
expect(Math.abs(b - a - gap)).toBeLessThanOrEqual(1.5);
});
05 常见问题
只跑 Playwright webkit 够不够?
够扛回归与几何闸;对外发布仍建议用远程 Mac 真机 Safari补一层,尤其是滚动、合成与系统滚动条宽度组合。
子网能和绝对定位浮层混用吗?
可以,但要和 层叠文 一起测,避免 z-index 与新层叠上下文盖住对齐参考线。
更多文章:博客列表。