2026 遠端 Mac 前端發布驗收:
CSS text-wrap pretty/balance 與 Safari 排版差異對照表及漸進增強三步清單
面向前端工程師與設計系統維護者:二〇二六排版 Token 若在 Linux Chromium 單測,Safari 仍可能出現末行孤字與卡片多一行。本文給出 text-wrap: balance / pretty 雙端對照表、標題卡片漂移說明、Playwright WebKit + 硬體 Safari 驗收路徑與發布前三步閘。延伸閱讀 Container Queries 與 @layer 專文、Safari 相容性 Playwright 系列。
痛點拆解(編號)🚀
一Chromium 能把短標題拉平 rag,Safari 在 flex 子項無明確行內尺寸 時 balance 常不生效,Playwright 全綠≠真機好看。
二設計 Token 給正文上了 pretty,卡片卻與 -webkit-line-clamp 疊在同一節點,評審仍見寡行與 widow。
三Retina 縮放下硬體 Safari 亞畫素舍入與 WebKit 字型目錄不同,營銷 Hero 行高在 CI 截圖裡差 2px 即換行。可對照 雙 Safari Playwright 矩陣 固化 lane。
① 屬性支援與回退:Safari 對照 Chromium
上線前填此表;務必疊加 overflow-wrap: anywhere、hyphens: auto 與 ch 單位 最大行寬,不支援時仍能安全換行。
| 能力維度 | Safari(WebKit · 遠端真機) | Chromium(Playwright) | 回退策略 |
|---|---|---|---|
| text-wrap: balance | 新 WebKit 支援;flex/grid 子項需明確寬度才拉平 | 塊級標題有寬度時 rag 較穩 | @supports (text-wrap: balance) 門控 |
| text-wrap: pretty | 多行正文減 orphan;中英混排斷點另測 | 與 text-wrap: wrap 組合順滑 |
先 pretty 後 balance,分 Token 層 |
| 遺留回退 | text-wrap: stable + 手動 max-width |
同左;輪播內勿單靠 balance | 特性為 false 時僅基礎換行 |
| 特性探測 | 映象 Chromium 的 @supports 分支 |
CI 注入斷言 computed text-wrap |
增強路徑可 Feature flag 關 |
| 漸進增強 | 營銷標題 balance;描述 pretty | 按鈕基線勿放進 balance 節點 | 見下文三步閘 |
② 標題與卡片排版差異(設計系統必看)
容器查詢改變卡片可用寬度時,balance 會重算行數,Chromium 與 Safari 可能差一整行。配合 Container Queries 驗收文 一併簽出。
- balance 寫在內部
<span>;-webkit-line-clamp留在外層盒。 - 展示標題 balance 前上限 4 行;更長改 pretty 或手動斷行。
- 驗收記 line box 高度,不只數字符數;Hero 在 1x / 2x 各錄屏一次。
③ Playwright WebKit + 真機 Safari 在遠端 Mac 上的驗收
租用節點先跑自動化,再 SSH/VNC 開硬體 Safari;參數與 Safari Playwright 專題 對齊。
npx playwright test typography-textwrap.spec.ts \ --project=webkit \ --workers=1 \ --retries=1 \ --trace=on-first-retry \ --timeout=40000
- 三張卡片標題冷啟兩次,bounding box 高度 漂移 ≤ 2px。
- 斷言
getComputedStyle的text-wrap;門控為真時期望balance。 - 分片 CI 對照 Stable/STP 矩陣 索引 trace。
- 真機對照 Web Inspector 末行寬度,附錄屏進發版工單。
④ 發布前三步驗收(漸進增強門禁)
- 基線僅基礎換行。hyphens、overflow-wrap、ch 行寬;雙引擎採卡片網格 CLS 中位數。
- 正文 Token 啟用 pretty。WebKit 快照黃金段落 orphan 詞數 ≤ 1,否則 CI 失敗。
- @supports 門控 balance。僅 definite 寬度元件;flex 末行孤字在硬體 Safari 為 0。
- 迴歸束。重跑 typography spec + 一篇 Container Queries layout spec。
- 真機雙籤。按 幫助中心 登遠端 Mac,Hero 與卡片截圖對照 Chromium trace。
⑤ FAQ:balance、pretty 與 line-clamp
問:卡片標題用 balance 還是 pretty?
答:短標題約四行內用 balance;描述用 pretty。保留 overflow-wrap 與 hyphens。
問:Playwright 綠但 Safari 仍醜?
答:字型與亞畫素不同。在硬體 WebKit 量 line box,勿只看畫素 diff。
問:與 line-clamp 衝突嗎?
答:clamp 外層、text-wrap 內層 span,避免 WebKit 跳過 balance。
據 可引用資訊(至少三條)
營銷卡片標題 balance 前寬度建議 ≤ 42ch,避免窄容器多出一行。
M 系遠端 Mac 單條 typography spec 預算 40s,trace=on-first-retry。
同視口下 Chromium 與硬體 Safari 標題盒高度漂移 ≤ 2px。
租用遠端 Mac 前端測試環境:硬體 Safari 與 Playwright WebKit 同機簽字
繼續閱讀 Safari Playwright 專題 與 Container Queries 清單;首頁、資費、SSH/VNC 指南 均免登入。部落格列表 含更多 Safari 相容性專題。