HTML渲染设置
from ironpdf import *

# Instantiate Renderer
renderer = ChromePdfRenderer()

# Many rendering options to use to customize!
renderer.RenderingOptions.SetCustomPaperSizeInInches(12.5, 20)
renderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape
renderer.RenderingOptions.Title = "My PDF Document Name"
renderer.RenderingOptions.EnableJavaScript = True
renderer.RenderingOptions.WaitFor.RenderDelay(50) # in milliseconds
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen
renderer.RenderingOptions.FitToPaperMode = FitToPaperModes.Zoom
renderer.RenderingOptions.Zoom = 100
renderer.RenderingOptions.CreatePdfFormsFromHtml = True
 
# Supports margin customization!
renderer.RenderingOptions.MarginTop = 40 # millimeters
renderer.RenderingOptions.MarginLeft = 20 # millimeters
renderer.RenderingOptions.MarginRight = 20 # millimeters
renderer.RenderingOptions.MarginBottom = 40 # millimeters
 
# Can set FirstPageNumber if you have a cover page
renderer.RenderingOptions.FirstPageNumber = 1 # use 2 if a cover page will be appended
 
# Settings have been set, we can render:
renderer.RenderUrlAsPdf("https://www.wikipedia.org/").SaveAs("my-content.pdf")
pip install ironpdf
HTML渲染设置

HTML渲染设置

IronPDF for Python 通过 ChromePdfRenderer.RenderingOptions 属性暴露丰富的渲染选项,为生成的 PDF 的各个方面提供精确控制。

开始

实例化一个 ChromePdfRenderer,调整其 RenderingOptions 对象上的属性,然后调用渲染方法之一。 您设置的每个选项都会应用于该渲染器实例生成的所有PDF。

理解代码

  • SetCustomPaperSizeInInches:以英寸定义非标准页面宽度和高度。
  • PrintHtmlBackgrounds:当 True 时,CSS 背景颜色和图像将包括在输出中。
  • PaperOrientation:接受 PdfPaperOrientation.Landscape 或 Portrait。
  • Title:设置 PDF 元数据中可见的内部文档标题。
  • EnableJavaScript:允许内联 <script> 块和外部脚本在 PDF 渲染之前执行。
  • WaitFor.RenderDelay:暂停指定毫秒数以便渲染,适用于需要时间完成的 JavaScript。
  • CssMediaType:在 Screen 和 Print CSS 规则之间切换以控制应用哪种样式表。
  • AutomaticFit)。
  • Zoom:页面内容应用的百分比缩放级别。
  • CreatePdfFormsFromHtml:当 True 时,HTML <input> 和 <select> 元素将转换为交互式 PDF 表单字段。
  • MarginTop / MarginLeft / MarginRight / MarginBottom:以毫米设置页面边距。
  • FirstPageNumber:起始页码,适用于在文档前加上封面页。

应用选项

在调用 RenderHtmlAsPdf 或 RenderHtmlFileAsPdf 等渲染方法之前设置所有选项。 渲染器可以在多个渲染调用中重复使用,并使用相同的设置。

学习如何使用IronPDF for Python将HTML转换为PDF!

准备开始了吗?

版本:2026.11刚刚发布