PySide6打印HTML表格时宽高设置不生效、表格塌陷问题求助

问题根因 #

PySide6 中QTextDocument对HTML/CSS的支持能力有限，仅支持有限的CSS2规则，不支持百分比宽度计算、部分行内样式规则，和浏览器的完整渲染逻辑差异较大，所以会出现样式不生效、表格塌陷的问题。

解决方案1：调整现有QTextDocument实现（适合简单HTML场景） #

1. 修改Python代码 #

在渲染HTML前手动同步QTextDocument和打印机的页面尺寸，保证样式比例匹配：

from PySide6.QtGui import (
    QPageSize,
    QPageLayout,
    QTextBlockFormat,
    QTextCursor,
    QTextDocument,
    QTextFormat,
)
from PySide6.QtWidgets import QApplication
from PySide6.QtPrintSupport import QPrinter, QPrintPreviewDialog

app = QApplication()

dialog = QPrintPreviewDialog()

def handle_paint_requested(printer):
    # 先固定打印页面尺寸为A4，可按需调整
    printer.setPageSize(QPageSize(QPageSize.A4))
    document = QTextDocument()
    # 同步文档尺寸和打印机可打印区域尺寸
    document.setPageSize(printer.pageRect(QPrinter.DevicePixel).size())
   
    with open("template.html", "r", encoding="utf-8") as f:
        billTemplate = f.read()

    document.setHtml(billTemplate)
    document.print_(printer)

dialog.paintRequested.connect(handle_paint_requested)
dialog.exec()

2. 修改HTML模板 #

把百分比宽度改为固定像素，添加table-layout: fixed规则提升样式兼容性：

<p>&nbsp;</p>
<table style="border-collapse: collapse; width: 300px; table-layout: fixed;" border="1">
    <tbody>
        <tr>
            <td style="width: 150px; height: 50px;">test1</td>
            <td style="width: 150px; height: 50px;">&nbsp;</td>
        </tr>
    </tbody>
</table>

解决方案2：改用QWebEngineView渲染打印（适合复杂HTML场景，效果和浏览器完全一致） #

如果你的HTML样式比较复杂，推荐改用基于Chromium内核的QWebEngineView来渲染，样式还原度和浏览器完全一致：

from PySide6.QtWidgets import QApplication
from PySide6.QtPrintSupport import QPrintPreviewDialog
from PySide6.QtWebEngineWidgets import QWebEngineView

app = QApplication()
dialog = QPrintPreviewDialog()
view = QWebEngineView()

def handle_paint_requested(printer):
    with open("template.html", "r", encoding="utf-8") as f:
        html_content = f.read()
    view.setHtml(html_content)
    # 等待页面加载完成后打印
    def on_load_finished(ok):
        if ok:
            view.print(printer, lambda *args: None)
    view.loadFinished.connect(on_load_finished)

dialog.paintRequested.connect(handle_paint_requested)
dialog.exec()

使用这个方案不需要修改原有的HTML模板，即可得到和浏览器一致的打印效果。

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