IronPDF 中的像素級精準 HTML 格式化

This article was translated from English: Does it need improvement?
Translated
View the article in English

若要讓您的 PDF 檔案呈現完美效果,您需要開發出色的 HTML 範本,或委託網頁開發人員代為處理。 這篇疑難排解文章摘自《HTML 除錯》的完整教學指南

1. 除錯並測試您的 HTML

您可以在 Chrome 或類似的桌面瀏覽器中,對 HTML、CSS 和 JS 進行除錯。 接著,當您確認運作無誤後,將其連接到 IronPDF,其顯示效果將與在 Chrome 中的樣貌完全一致。

基本用法

此程式碼範例將渲染出與最新版 Chrome 桌面瀏覽器像素完全吻合的 PDF 檔案。

// Create a new ChromePdfRenderer instance
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set the CSS media type to 'Print'
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

// Ensure HTML backgrounds are printed
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
// Create a new ChromePdfRenderer instance
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set the CSS media type to 'Print'
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

// Ensure HTML backgrounds are printed
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
' Create a new ChromePdfRenderer instance
Dim renderer As New ChromePdfRenderer()

' Set the CSS media type to 'Print'
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print

' Ensure HTML backgrounds are printed
renderer.RenderingOptions.PrintHtmlBackgrounds = True
$vbLabelText   $csharpLabel

進階 HTML 開發

進階的 Chrome 使用者開發者可透過使用 IronPDF 的預設設定,並啟用"模擬 CSS 媒體 > 螢幕"選項,達到 100% 的精準度。 更多資訊請參閱此處

// Create a new ChromePdfRenderer instance
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set the CSS media type to 'Screen' for better preview consistency
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Screen;

// Ensure HTML backgrounds are printed
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
// Create a new ChromePdfRenderer instance
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set the CSS media type to 'Screen' for better preview consistency
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Screen;

// Ensure HTML backgrounds are printed
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
' Create a new ChromePdfRenderer instance
Dim renderer As New ChromePdfRenderer()

' Set the CSS media type to 'Screen' for better preview consistency
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Screen

' Ensure HTML backgrounds are printed
renderer.RenderingOptions.PrintHtmlBackgrounds = True
$vbLabelText   $csharpLabel

2. 比較結果

若要比較結果,請在 Chrome 桌面版瀏覽器中開啟您的 HTML 檔案。

注意:請將所有 HTML 字串及資源匯出至獨立的 HTML 檔案並手動編輯,或請網頁開發人員協助處理。

PDF 結果比較

3. 開啟列印預覽視窗(Windows 系統請按 Ctrl+P)

您可能需要在 Chrome 的"列印"對話方塊中調整紙張尺寸,並啟用列印背景圖片的功能。

列印預覽視窗

4. 選擇"另存為 PDF"選項

一旦 Chrome 的"列印為 PDF"功能臻於完美,IronPDF 將與之匹敵。

儲存為 PDF 選項

5. 執行 IronPDF

現在 HTML 已臻完美,將其透過 IronPDF 處理後,呈現效果將完全一致。 請使用 {PlaceHolders} 來嵌入客戶資料。 IronPDF 範例中的程式碼範例將非常有幫助!

若本教學無法協助您解決問題,請聯絡工程支援團隊,我們將據此調整並改進文件內容,以提供更完善的協助。

Curtis Chau
技術撰稿人

Curtis Chau 擁有卡爾頓大學(Carleton University)的電腦科學學士學位,專精於前端開發,並精通 Node.js、TypeScript、JavaScript 及 React。他熱衷於打造直觀且美觀的用戶介面,喜歡運用現代框架,並創建結構完善、視覺上吸引人的手冊。

除了開發工作之外,Curtis 對物聯網(IoT)抱有濃厚興趣,致力於探索整合硬體與軟體的創新方法。閒暇時,他喜歡玩遊戲和開發 Discord 機器人,將對科技的熱愛與創意相結合。

準備開始了嗎?
Nuget 下載 19,014,616 | 版本: 2026.5 just released
Still Scrolling Icon

還在往下捲動嗎?

想要快速確認成果嗎? PM > Install-Package IronPdf
執行範例 觀看您的 HTML 轉為 PDF。