如何用docxtemplater实现多行前缀标签空行自动移除？

问题背景 #

要复刻旧模板工具的前缀功能：当某一行中所有{$tag}格式的标签均未定义时，直接移除该行。但目前使用docxtemplater时，即使该行所有标签都未定义，仍会生成空行。试过inverted-sections、rawtags以及自定义parser/nullGetter，但现有方案都是针对单行单标签场景，无法适配多个标签并排的情况。

当前使用的配置：

const options = {
    paragraphLoop: true, 
    linebreaks: false,
    parser: function(tag) {
        return {
            get(scope, context) {
                console.log(tag);
                console.log(scope);
                console.log(context);
                if (tag[0] == "$") {
                    tag = tag.substr(1); // 需要移除换行
                }
                return scope[tag];
            }
        }
    },
    nullGetter: function nullGetter(part, scopeManager) {
        if (!part.module) {
            return "";
        }
        if (part.module === "rawxml") {
            return "";
        }
        return "";
    }
};
doc = new Docxtemplater(zip, options);

测试场景 #

测试数据 #

existingtag: EXISTINGTAG

模板内容 #

1 text above
{$existingtag}{$nonexistingtag}
text below

2 text above
{$existingtag}{$existingtag}
text below

3 text above
{$nonexistingtag}{$nonexistingtag}
text below

期望输出 #

1 text above
EXISTINGTAG
text below

2 text above
EXISTINGTAGEXISTINGTAG
text below

3 text above
text below

当前实际输出（存在空行问题） #

1 text above
EXISTINGTAG
text below

2 text above
EXISTINGTAGEXISTINGTAG
text below

3 text above

text below

解决方案 #

要实现整行标签全为空时移除该行，需要结合docxtemplater的段落处理钩子和自定义逻辑，判断段落内所有标签是否都未定义：

1. 保留paragraphLoop: true配置，确保能逐段处理；
2. 添加postProcess钩子，在模板渲染完成后检查并移除空段落。

修改后的配置如下：

const options = {
    paragraphLoop: true,
    linebreaks: false,
    parser: function(tag) {
        return {
            get(scope) {
                if (tag.startsWith("$")) {
                    tag = tag.slice(1);
                }
                // 未定义标签返回undefined，触发nullGetter转为空字符串
                return scope.hasOwnProperty(tag) ? scope[tag] : undefined;
            }
        };
    },
    nullGetter: function() {
        // 未定义标签统一渲染为空
        return "";
    },
    postProcess: function(xml) {
        // 匹配仅含空文本的段落并移除
        return xml.replace(/<w:p[^>]*>(?:<w:r[^>]*><w:t><\/w:t><\/w:r>)*<\/w:p>/g, "");
    }
};

doc = new Docxtemplater(zip, options);

补充说明 #

• postProcess中的正则会精准匹配内容为空的段落（仅包含空文本节点的段落），直接替换为空实现移除空行；
• 自定义parser对未定义标签返回undefined，确保nullGetter能正确将其转为空字符串，最终让整段内容为空；
• 若段落包含非标签内容（如空格、固定文本），则不会被误移除，完全符合需求。

内容的提问来源于stack exchange，提问作者plz-help-123