iText 7 自定义annot注释标签继承父级负text-indent样式失效问题

问题原因 #

你遇到的样式异常核心是自定义<annot>标签的标签处理器继承了PTagWorker（段落块级元素处理器），导致iText将<annot>识别为块级元素，触发了父级p标签的负text-indent属性，同时自定义标签的CSS样式未被iText默认解析映射，所以你写的text-indent:0不生效。

解决方案 #

修改自定义标签的处理器逻辑，将其改为行内元素处理，同时手动屏蔽缩进属性：

1. 把AnnotTagWorker的父类从PTagWorker替换为SpanTagWorker，适配行内元素属性
2. 在生成元素时手动设置缩进为0，完全规避继承问题
3. 对应修改渲染器继承SpanRenderer保证行内区域计算正确

修改后的核心代码 #

private static class CustomTagWorkerFactory extends DefaultTagWorkerFactory {
    @Override
    public ITagWorker getCustomTagWorker(IElementNode tag, ProcessorContext context) {
        if ("annot".equals(tag.name())) {
            return new AnnotTagWorker(tag, context);
        }
        return super.getCustomTagWorker(tag, context);
    }
}

// 改为继承SpanTagWorker，处理行内元素
private static class AnnotTagWorker extends SpanTagWorker {
    public AnnotTagWorker(IElementNode element, ProcessorContext context) {
        super(element, context);
    }

    @Override
    public IPropertyContainer getElementResult() {
        IPropertyContainer baseResult = super.getElementResult();
        if (baseResult instanceof Span) {
            Span annotSpan = (Span) baseResult;
            // 手动设置缩进为0，彻底屏蔽父级继承
            annotSpan.setTextIndent(0);
            annotSpan.setNextRenderer(new AnnotTagRenderer(annotSpan));
        }
        return baseResult;
    }
}

// 改为继承SpanRenderer，正确计算行内元素占用区域
private static class AnnotTagRenderer extends SpanRenderer {
    public AnnotTagRenderer(Span modelElement) {
        super(modelElement);
    }

    @Override
    public IRenderer getNextRenderer() {
        return new AnnotTagRenderer((Span) modelElement);
    }

    @Override
    public void draw(DrawContext drawContext) {
        super.draw(drawContext);
        // 原有高亮注释生成逻辑保持不变
        Rectangle occupiedArea = this.getOccupiedAreaBBox();
        float[] quadPoints = new float[] {occupiedArea.getLeft(), occupiedArea.getTop(), occupiedArea.getRight(), occupiedArea.getTop(),
                occupiedArea.getLeft(), occupiedArea.getBottom(), occupiedArea.getRight(), occupiedArea.getBottom()};
        PdfAnnotation ann = PdfTextMarkupAnnotation.createHighLight(
                        new Rectangle(occupiedArea), quadPoints)
                .setColor(ColorConstants.YELLOW)
                .setTitle(new PdfString("Hello!"))
                .setContents(new PdfString("I'm a popup."))
                .setTitle(new PdfString("iText"));
        drawContext.getDocument().getPage(this.getOccupiedArea().getPageNumber()).addAnnotation(ann);
    }
}

修改后不需要调整原有HTML和其他逻辑，生成的PDF中annot标签会作为行内文本和前后内容正常排版，不会出现重叠问题，高亮注释的位置也会完全匹配标记文本。

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