响应式HTML到PDF
from ironpdf import *

# Instantiate Renderer
renderer = ChromePdfRenderer()

# Choose Screen or Print CSS media

renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen

# Set the width of the responsive virtual browser window in pixels
renderer.RenderingOptions.ViewPortWidth = 1920

# Set paper mode to automatic fit to physical paper
renderer.RenderingOptions.FitToPaperMode = FitToPaperModes.AutomaticFit

# Render an HTML file
pdf = renderer.RenderHtmlFileAsPdf("Responsive.html")
pip install ironpdf
响应式HTML到PDF

响应式HTML到PDF

IronPDF for Python允许您控制在渲染过程中的虚拟浏览器视口宽度,确保响应式HTML布局在正确的断点被捕获。

开始

在调用渲染方法之前,在FitToPaperMode。 这三个设置协同工作以控制页面布局如何评估和缩放以适应PDF纸张尺寸。

理解代码

  • CssMediaType = PdfCssMediaType.Screen: 应用@media screen CSS规则而不是打印样式。 当页面有一个需要保留的响应式桌面布局时,使用此选项。
  • ViewPortWidth = 1920: 设置虚拟浏览器窗口的宽度(像素)。 页面会像在一个1920px宽的浏览器中查看一样布局,激活相应的响应式断点。
  • FitToPaperMode = FitToPaperModes.AutomaticFit: 自动缩放渲染内容以适应物理PDF页面尺寸,避免裁切或溢出内容。
  • RenderHtmlFileAsPdf("Responsive.html"): 使用已配置的视口设置渲染本地HTML文件。

选择正确的视口宽度

将ViewPortWidth与您的HTML设计的断点匹配。 常见的值是:

  • 1920 - 全高清桌面布局
  • 1280 - 标准宽屏桌面
  • 768 - 平板/中等断点
  • 375 - 移动布局
学习如何使用IronPDF for Python将HTML转换为PDF!

准备开始了吗?

版本:2026.11刚刚发布