不支援的 CSS 功能與替代做法

概覽

writeHtml 引擎會以單一向前遍歷繪製內容，絕不會對先前已繪製的內容重新排版。有些 Cascading Style Sheets（CSS）行為並不符合這個模型。本頁列出引擎不會套用的特定行為，並為每一項提供受支援的替代做法。各模組的驗證狀態請參見 CSS 支援對照表。

這些限制都有明確範圍，並不是路線圖。每個條目都指出確切不支援的行為，而不是代表整個屬性都不支援。

不支援的行為

行為	不會套用的部分	替代做法
position: absolute / position: relative 偏移版面配置	引擎會依文件順序放置方塊。用於將已定位方塊移出正常流的 top/right/bottom/left 偏移不會套用。靜態定位仍可正常運作。	在正常流中使用表格或 flex 進行版面配置。
具名的 grid-template-areas	引擎並未實作透過具名格線區域進行放置。明確的格線線條放置仍可正常運作。	使用明確的格線線條放置項目，或改用表格。
跨越斷頁的 rowspan（降級）	rowspan 儲存格會繪製在單一頁面上。當表格分頁時，跨越頁面邊界的跨列儲存格會依架構決策記錄（ADR-007）所述進行切分；過高而無法切分的儲存格則會引發 UnsplittableContentException。	對於分頁期間必須維持完整的成組列，請使用 float 或類別標題列，而非過高的 rowspan。
overflow: hidden 的背景繪製順序	overflow: hidden 不會改變背景的繪製順序，也不會將子元素的背景裁切到祖先元素的圓角或固定尺寸方塊內。	將背景套用到具有該裁切效果的元素上，或不要倚賴被裁切的背景。
flex 項目內並排換行的文字	包含換行文字的 flex 項目會溢出其軌道，而非在軌道內換行。	使用具有明確像素欄寬的雙欄表格。
解析為零的百分比欄寬	當 % 欄的 width 沒有可解析的基準時，會被解析為 0，並觸發欄壓縮警告。	為並排的欄指定明確像素寬度。

另請參閱

• CSS 支援對照表 — 各模組的驗證狀態與受支援功能。
• HTML：HTML+CSS 轉 PDF 繪製子系統 — 這些限制背後的單一遍歷模型。
• 排版 HTML 表格 — 可用來取代偏移定位與 flex 換行文字的表格樣式。