Docx4j转换多CSS类HTML问题：如何应用多个CSS类属性？

Docx4j默认的HTML导入器在处理多类选择器时，确实会出现样式覆盖的问题——同一元素的多个CSS类只会生效其中一个。以下是几种可行的解决方法：

1. 自定义CSS样式合并逻辑（推荐） #

通过扩展Docx4j的CssApplierFactory和CssApplier，手动遍历元素的所有CSS类，逐个应用样式并合并属性，避免单一类覆盖其他类的样式。

自定义CssApplier实现 #

import org.docx4j.convert.in.xhtml.CssApplier;
import org.docx4j.convert.in.xhtml.CssApplierFactory;
import org.docx4j.convert.in.xhtml.ElementMapping;
import org.docx4j.wml.P;
import org.w3c.dom.Element;

public class MultiClassCssApplierFactory extends CssApplierFactory {
    @Override
    public CssApplier createCssApplier(Element element, ElementMapping elementMapping) {
        return new MultiClassCssApplier(element, elementMapping);
    }

    private static class MultiClassCssApplier extends CssApplier {
        public MultiClassCssApplier(Element element, ElementMapping elementMapping) {
            super(element, elementMapping);
        }

        @Override
        protected void applyStyles(P p, Element e) {
            // 拆分元素的所有CSS类
            String[] classNames = e.getAttribute("class").split("\\s+");
            
            // 遍历每个类，依次应用对应样式
            for (String className : classNames) {
                if (className.isEmpty()) continue;
                
                StyleClass styleClass = getStyleClass(className);
                if (styleClass != null) {
                    // 应用当前类的样式，属性会自动合并（后应用的不会覆盖已存在的冲突属性，需根据需求调整优先级）
                    applyStyleClass(p, styleClass, e);
                }
            }
        }
    }
}

在转换时使用自定义工厂 #

import org.docx4j.openpackaging.packages.WordprocessingMLPackage;
import org.docx4j.convert.in.xhtml.XHTMLImporterImpl;
import java.io.File;

// 初始化Word文档包
WordprocessingMLPackage wordMLPackage = WordprocessingMLPackage.createPackage();

// 创建HTML导入器并设置自定义CSS应用工厂
XHTMLImporterImpl importer = new XHTMLImporterImpl(wordMLPackage);
importer.setCssApplierFactory(new MultiClassCssApplierFactory());

// 导入处理后的HTML
wordMLPackage.getMainDocumentPart().getContent().addAll(
    importer.convert(yourHtmlString, null)
);

// 保存文档
wordMLPackage.save(new File("output.docx"));

2. 预处理HTML合并多类（临时快速方案） #

如果不想修改Docx4j的核心逻辑，可以先用HTML解析工具（比如Jsoup）将多类元素的样式合并为单个类，再导入Docx4j。

Jsoup预处理示例 #

import org.jsoup.Jsoup;
import org.jsoup.nodes.Document;
import org.jsoup.nodes.Element;
import org.jsoup.select.Elements;

public class HtmlMultiClassMerger {
    public static String mergeClasses(String rawHtml, String cssContent) {
        Document doc = Jsoup.parse(rawHtml);
        Elements multiClassPTags = doc.select("p[class~=\\s+]"); // 匹配带多个类的p标签

        for (Element p : multiClassPTags) {
            String[] classes = p.attr("class").split("\\s+");
            StringBuilder mergedClass = new StringBuilder();
            StringBuilder combinedStyles = new StringBuilder();

            // 拼接新类名并合并对应样式
            for (String cls : classes) {
                mergedClass.append(cls).append("-");
                // 从CSS中提取当前类的样式规则（简化实现，复杂场景建议用专业CSS解析库）
                int ruleStart = cssContent.indexOf("." + cls);
                if (ruleStart == -1) continue;
                int ruleEnd = cssContent.indexOf("}", ruleStart) + 1;
                String rule = cssContent.substring(ruleStart, ruleEnd);
                String styles = rule.substring(rule.indexOf("{") + 1, rule.indexOf("}")).trim();
                combinedStyles.append(styles).append("; ");
            }

            // 生成合并后的类和样式
            String finalClass = mergedClass.deleteCharAt(mergedClass.length() - 1).toString();
            doc.head().append("<style>." + finalClass + " {" + combinedStyles + "}</style>");
            // 替换p标签的class属性
            p.attr("class", finalClass);
        }

        return doc.html();
    }
}

使用时先预处理HTML，再导入：

String processedHtml = HtmlMultiClassMerger.mergeClasses(originalHtml, yourCssString);
// 再用Docx4j的默认导入器处理processedHtml

3. 升级Docx4j版本 #

部分旧版Docx4j的HTML导入器存在多类处理缺陷，升级到最新稳定版（比如11.x以上）可能直接解决问题。确保你的依赖中包含最新的docx4j-core和docx4j-ImportXHTML。

内容的提问来源于stack exchange，提问作者Nguyen Tran Nhat Vu