You are currently offline, serving cached version

Usage (nodejs)

const PPModule = require("docxtemplater-pp-module");
const fs = require("fs");

const zip = new PizZip(fs.readFileSync("input.docx"));
const doc = new Docxtemplater(zip, {
    modules: [new PPModule({})],
});

doc.render({
    company_name: "Acme Corp",
    company_shareprice: 20.93,
});

const buffer = doc.getZip().generate({
    type: "nodebuffer",
    compression: "DEFLATE",
});

fs.writeFile("test.docx", buffer);

In the browser, use following html file :

<html>
    <script src="node_modules/docxtemplater/build/docxtemplater.js"></script>
    <script src="node_modules/pizzip/dist/pizzip.js"></script>
    <script src="node_modules/pizzip/vendor/FileSaver.js"></script>
    <script src="node_modules/pizzip/dist/pizzip-utils.js"></script>
    <script src="build/pp-module.js"></script>
    <script>
        PizZipUtils.getBinaryContent(
            "examples/demo.docx",
            function (error, content) {
                if (error) {
                    console.error(error);
                    return;
                }

                const zip = new PizZip(content);
                const doc = new docxtemplater(zip, {
                    modules: [new DocxtemplaterPPModule({})],
                });

                doc.render({
                    company_name: "Acme Corp",
                    company_shareprice: 20.93,
                });
                const out = doc.getZip().generate({
                    type: "blob",
                    mimeType:
                        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
                });
                saveAs(out, "generated.docx");
            }
        );
    </script>
</html>

Behavior

Your docx should contain the text: {?data}. After installing the module, you can use a working demo by running node sample.js.

When a tag beginning with a question mark (?) is found, the tag value is calculated.

  • If the tag value is falsy the whole paragraph containing the tag is removed.

  • If the tag is true, the paragraph is kept but the tag is replaced to "".

  • If the tag value is truthy, the tag is replaced normally and the paragraph is kept.

If there are multiple "paragraph placeholder" tags in the same paragraph, the paragraph will be removed if one of the values is falsy. Only if all values are truthy, the paragraph is kept.

Shapes

It is possible to show or hide a shape in a diagram using this module, simply with this template :

Shape Show/Hide Demo
Show or hide a shape using the {?cond1} tag

doc.render({
    cond1: true,
    cond2: false,
    user: "John",
    employer: "Mary",
    name: "Max",
});

Shape Show/Hide Demo Result
Result document

CHANGELOG

3.4.0

Add support, for shapes, which allows to show or hide a shape.

3.3.2

When using this module with the docxtemplater option {linebreaks: true}, the rendered elements will also contain linebreaks.

3.3.1

When using this module in async mode inside a loop, the following message would appear :

TypeError: Cannot read properties of undefined (reading 'value')
    at ScopeManager._getValue (.../paragraph-placeholder/node_modules/docxtemplater/js/scope-manager.js:49:7)

Now, the module works well even when the tag is placed inside a loop.

3.3.0

Make module compatible with docxtemplater@3.28.0. Please make sure to update docxtemplater to 3.28.0 at the same time you update this module. The internal change made is the use of the new matchers API which fixes bugs that were triggered depending on the order of the modules that are attached to the instance. Now the order of the modules should not matter as expected.

3.2.5

Use @xmldom/xmldom instead of xmldom, see this github issue

3.2.4

Generate files in built with correct filename In previous versions, the filename was always build/docxtemplater.js. Now the filename is build/pp-module.js The .min.js file is also created now.

3.2.3

Add typescript definitions for public API

3.2.2

Bugfix "Cannot read property 'offset' of undefined, when using multiple paragraph placeholder tags in the same paragraph

3.2.1

Declare supportedFileTypes, which allows to use this module with the new docxtemplater constructor which was introduced in docxtemplater 3.17.

3.2.0

Hide value if value === true (in that case, show the paragraph but don't display any value)

3.1.0

Add support for pptx format (Powerpoint files)

3.0.0

Initial release

Talk with sales