如何用iText7将HTML解析为可添加到PDF指定区域的元素并保留样式？

我在Java Web的PDF生成应用中，使用iText7-core 7.2.5和html2pdf 4.0.5实现功能：用户输入HTML字符串，指定页面上的矩形区域来渲染该HTML。

目前我用HtmlConverter.convertToElements(htmlString)得到List<IElement>，然后遍历元素逐个处理，核心代码如下：

for (IElement element : elements){
    float padding = 5f;
    if (blockElement instanceof Paragraph){
        Paragraph p = (Paragraph) blockElement;

        // calculate the height of the Paragraph
        float marginTop = (p.getMarginTop() != null) ? p.getMarginTop().getValue() : 0;
        float marginBottom = (p.getMarginBottom() != null) ? p.getMarginBottom().getValue() : 0;
        float paddingTop = (p.getPaddingTop() != null) ? p.getPaddingTop().getValue() : 0;
        float paddingBottom = (p.getPaddingBottom() != null) ? p.getPaddingBottom().getValue() : 0;
        float height = marginTop + marginBottom + paddingTop + paddingBottom;

        // check if the currentYPosition has enough space for the new Paragraph
        if ((currentYPosition.getCurrentYPosition() - height) < htmlRectangle.getBottom()) {
            // add new page and reset the currentYPosition
            canvas = new Canvas(new PdfCanvas(pdfDocument.addNewPage()), htmlRectangle);
            currentYPosition.setCurrentYPosition(htmlRectangle.getTop());
        }

        canvas.showTextAligned(p, htmlRectangle.getLeft(), currentYPosition.getCurrentYPosition() - p.getMarginTop().getValue(), txtAlignment);
        currentYPosition.setCurrentYPosition(currentYPosition.getCurrentYPosition() - (height + padding));
    } else if (blockElement instanceof Div) {
        Div div = (Div) blockElement;
        ...
    } else if (blockElement instanceof whatever){
        ...
    } ...
}

当前方案能运行，但有两个明显问题：

• 样式丢失严重，比如<h1>Sample Heading</h1>没有渲染成大号粗体，而是小号普通文本。
• 必须用冗长的else-if链处理所有可能的HTML对应元素类型。

已知限制：不能用HtmlConverter.convertToPdf（会创建新文档），也不能直接用Document.add((IBlockElement)element)（需要指定画布位置）。

1. 解决样式丢失问题 #

直接调用HtmlConverter.convertToElements时未传入样式解析配置，导致html2pdf默认的HTML标签样式（如h1的字号、粗细）未被应用。需创建ConverterProperties并启用默认CSS样式支持：

ConverterProperties properties = new ConverterProperties();
// 启用默认CSS样式解析
properties.setCssApplierFactory(new DefaultCssApplierFactory());
// 可选：若有自定义CSS或外部资源，可设置基础路径
// properties.setBaseUri("your-resource-path");
List<IElement> elements = HtmlConverter.convertToElements(htmlString, properties);

转换后的元素会自动带上对应HTML标签的默认样式，无需手动设置字体、边距等属性。

2. 替代冗长的else-if链：统一处理IBlockElement #

iText7的IBlockElement是所有块级元素（Paragraph、Div、Heading等）的父接口，可直接判断元素类型为IBlockElement，利用iText内置布局引擎统一处理布局和高度计算，无需逐个判断元素类型：

优化后的核心代码：

ConverterProperties properties = new ConverterProperties();
properties.setCssApplierFactory(new DefaultCssApplierFactory());
List<IElement> elements = HtmlConverter.convertToElements(htmlString, properties);

float currentY = htmlRectangle.getTop();
Canvas canvas = new Canvas(new PdfCanvas(pdfDocument.getFirstPage()), htmlRectangle);

for (IElement element : elements) {
    if (!(element instanceof IBlockElement blockElement)) {
        continue; // 跳过非块级元素，按需处理行内元素
    }

    // 计算元素在当前剩余空间的实际占用高度
    LayoutArea availableArea = new LayoutArea(1, new Rectangle(
        htmlRectangle.getLeft(), 
        htmlRectangle.getBottom(), 
        htmlRectangle.getWidth(), 
        currentY - htmlRectangle.getBottom()
    ));
    LayoutResult result = blockElement.createRendererSubTree()
        .setParent(canvas.getRenderer())
        .layout(new LayoutContext(availableArea));
    float elementHeight = result.getOccupiedArea().getBBox().getHeight();

    // 剩余空间不足则分页
    if (currentY - elementHeight < htmlRectangle.getBottom()) {
        PdfPage newPage = pdfDocument.addNewPage();
        canvas = new Canvas(new PdfCanvas(newPage), htmlRectangle);
        currentY = htmlRectangle.getTop();
        // 重新计算新页面上的元素高度
        availableArea = new LayoutArea(1, new Rectangle(
            htmlRectangle.getLeft(), 
            htmlRectangle.getBottom(), 
            htmlRectangle.getWidth(), 
            currentY - htmlRectangle.getBottom()
        ));
        result = blockElement.createRendererSubTree()
            .setParent(canvas.getRenderer())
            .layout(new LayoutContext(availableArea));
        elementHeight = result.getOccupiedArea().getBBox().getHeight();
    }

    // 添加元素到指定位置并更新Y坐标
    canvas.add(blockElement);
    currentY -= elementHeight;
}

核心优势： #

• 自动适配所有块级元素类型，无需逐个判断处理。
• 利用iText布局引擎精准计算元素高度（包含边距、内边距），避免手动计算误差。
• canvas.add自动应用元素样式，彻底解决样式丢失问题。

补充说明 #

若需处理行内元素（如Span），可将其包裹到Paragraph后再添加，或直接调用canvas.add，iText布局引擎会自动处理行内元素的排版逻辑。

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