使用WeasyPrint转换含表格的HTML为PDF的分页问题及解决需求

问题场景 #

使用WeasyPrint将包含单个表格（<td>内为图片或文本）的HTML转换为PDF时，表格会被分页符从列中间切开。需实现以下任一效果：

1. 缩放内容以适配单页高度
2. 自动调整页面高度匹配表格内容
   表格的行/列数动态可变，无法提前预知尺寸。

已尝试无效方法 #

• 使用CSS page.size 修改页面尺寸：因无法提前知晓表格尺寸，无法精准适配
• 添加 body, html{height: 100%;} 及大量 display:block：仅出现滚动条，未实现内容适配
• 设置 table {break-inside: avoid;}：无任何分页限制效果

方案1：缩放内容适配单页高度 #

通过动态计算表格高度，生成缩放比例，将表格缩放到目标页面高度内：

1. 解析HTML获取表格实际高度
   用Python的BeautifulSoup解析HTML，遍历表格行及单元格：

   • 若单元格为图片，提取图片的height属性值
   • 若为文本，按行高（如1.2em）估算高度
     累加得到表格总高度（单位统一为mm或px）

2. 生成动态缩放CSS
   以A4纵向页面高度（297mm）、宽度（210mm）为例，计算宽高方向的最小缩放比例，将表格包裹在容器中并应用缩放：

   .table-wrapper {
     transform: scale(min(calc(210mm / [表格实际宽度]), calc(297mm / [表格实际高度])));
     transform-origin: top left;
   }
   

3. 渲染PDF
   将带动态CSS的HTML传入WeasyPrint，即可生成单页缩放后的PDF。

方案2：自动调整页面高度适配内容 #

通过CSS强制页面高度随内容自动调整，并确保表格不被分页：

@page {
  size: auto; /* 让页面尺寸自动适配内容 */
  margin: 1cm; /* 可根据需求调整边距，设为0则无空白 */
}

table {
  break-inside: avoid !important; /* 强制表格不被分页 */
  page-break-inside: avoid !important; /* 兼容旧版CSS分页属性 */
  width: 100%; /* 确保表格适配页面宽度 */
}

body {
  margin: 0; /* 清除页面默认边距 */
}

注意事项 #

• 若表格宽度超过页面宽度，可添加 table { white-space: nowrap; } 防止单元格换行，或结合方案1的缩放逻辑同时适配宽高
• 确保图片未设置固定的超大尺寸，避免超出页面范围

内容的提问来源于stack exchange，提问作者tbrugere