📝 text-wrap · 排版簽出 · 雙引擎 · 二零二六

2026 遠端 Mac 前端發布驗收:
CSS text-wrap pretty/balance 與 Safari 排版差異對照表及漸進增強三步清單

2026.05.19 前端工程師 · 設計系統 約九分鐘閱讀

面向前端工程師與設計系統維護者:二〇二六排版 Token 若在 Linux Chromium 單測,Safari 仍可能出現末行孤字與卡片多一行。本文給出 text-wrap: balance / pretty 雙端對照表、標題卡片漂移說明、Playwright WebKit + 硬體 Safari 驗收路徑與發布前三步閘。延伸閱讀 Container Queries 與 @layer 專文、Safari 相容性 Playwright 系列。

對照表 · 三步閘 · WebKit 指令碼 · FAQ

痛點拆解(編號)🚀

一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 末行寬度,附錄屏進發版工單。

④ 發布前三步驗收(漸進增強門禁)

  1. 基線僅基礎換行。hyphens、overflow-wrap、ch 行寬;雙引擎採卡片網格 CLS 中位數。
  2. 正文 Token 啟用 pretty。WebKit 快照黃金段落 orphan 詞數 ≤ 1,否則 CI 失敗。
  3. @supports 門控 balance。僅 definite 寬度元件;flex 末行孤字在硬體 Safari 為 0。
  4. 迴歸束。重跑 typography spec + 一篇 Container Queries layout spec。
  5. 真機雙籤。按 幫助中心 登遠端 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 · 排版 QA 矩陣 · 免登入

租用遠端 Mac 前端測試環境:硬體 Safari 與 Playwright WebKit 同機簽字

繼續閱讀 Safari Playwright 專題 與 Container Queries 清單;首頁、資費、SSH/VNC 指南 均免登入。部落格列表 含更多 Safari 相容性專題。

部落格列表 · 首頁 · 購買頁

租用遠端 Mac 測排版