CHANGELOG

3.15.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.14.0

Make module compatible with docxtemplater@3.27.0. Please make sure to update docxtemplater to 3.27.0 at the same time you update this module

3.13.9

Allow to customize left, top, bottom, right, insideh or insidev value.

For example, like this :

const TableModule = require("docxtemplater-table-module");
const doc = new Docxtemplater(zip, {
    modules: [
        new TableModule.Full({
            border: {
                left: {
                    val: "triple",
                    size: 10,
                    color: "00FF00",
                },
            },
        }),
    ],
});

3.13.8

Bugfix corruption when using TableModule.GridPptx together with HtmlPptxModule.

3.13.7

Update typings for options html, border, cellMargin for TableModule.full

3.13.6

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

3.13.5

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

3.13.4

Add typescript definitions for public API

3.13.3

Allow to specifiy verticalAlign in style property ("top", "center", "bottom").

Also allow this property when using the grid table module.

3.13.2

Move webpack from dependency to devDependency (which triggered an error during installation on node version 10)

3.13.1

Internal change to allow to match tags with non-breaking space.

When entering Ctrl+Shift+Space, a "non-breaking" space is created.

When using a non-breaking space in the tag {:table data}, the tag would not be replaced correctly.

3.13.0

• Add support to customize the background color of a single cell (a table header or a normal cell), by using object in data like this (note that you can mix strings and objects in the table data) :

doc.render({
    table: {
        widths: [300, 300],
        data: [
            [
                "Text",
                {
                    text: "Right",
                    style: {
                        textAlign: "right",
                        shade: "FFDD88",
                    },
                },
            ],
            [
                {
                    text: "Left",
                    style: {
                        textAlign: "left",
                        shade: "DDFF88",
                    },
                },
                "lorem",
            ],
        ],
    },
});

3.12.0

• Add support for MergeCell module in pptx format
• Add support to customize the background color of table headers and subheaders using style.header.shade = "FF0000"
• Add support to customize the text-alignment of table style.header.textAlign = "right"

3.11.4

Bugfix, when using the TableModule.Module inside a loop, it would not work properly.

Now, even when the tag is inside a loop tag, it will still work.

The error would be the following previously :

The tag "1" is not inside a paragraph.

Now, the generation works well.

3.11.3

Bugfix, when using the FullTableModule, the resolver did not work (it catched all tags, thus having as consequence the fact that image tags for example where replaced with no data).

3.11.2

Bugfix, when using the FullTableModule with the HTMLmodule and the image module in async mode, the images would not be loaded correctly.

Now, images are shown even when using async mode together with the HTMLModule

3.11.1

Bugfix, when having empty data as in data: [["", ""]] for the Fulltable module together with the HTML module : html: true, the cells now have an empty paragraph.

3.11.0

Add support to have HTML as part of the data when using together with the HTML module. Note that when using this option, the automatic chunkSize will not infer the size of the table very accurately.

To enable this feature you need to use both the Table Module and the HTML module, and you should also add the html: true option to the table module.

const TableModule = require("docxtemplater-table-module");
const HtmlModule = require("docxtemplater-html-module");
const doc = new Docxtemplater(zip, {
    modules: [
        new HtmlModule(),
        new TableModule.Full({ html: true }),
    ],
});
doc.render({
    header: ["Header1", "Header2"],
    data: [
        ["<p><strong>Strong</strong> Text</p>", "Good"],
        ["<p><u>Underline</u> Text</p>", "Good"],
        ["<p><span style='color:#f00'>Red</u> Text</p>", "Good"],
    ],
});

When using this feature, all text that are inside the header, subheader or data parts will be rendered by converting HTML to docx.

3.10.2

Bugfix async support for TableModule.Merge when using together with subsection module

3.10.1

Add async support for TableModule.Merge (works with resolveData now)

3.10.0

Add new module to be able to merge adjacent cells together.

The syntax for that is : {:merge-cells-col 1}, that should be placed inside a table, which means that in the first column, all adjacent cells that have the same content should be merged together.

3.9.6

Bugfix Vertical Table Module in async mode (with resolveData).

Previously, an error would be thrown during render.

3.9.5

Do not render any element if data is empty

3.9.4

Add support for cellMargin.

3.9.3

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

3.9.2

Update to work with latest docxtemplater, version 3.15.4

3.9.1

With vertical-table loop module, it is now possible to have nested horizontal loops + simple vertical loops

3.9.0

With vertical-table loop module, when you have row loops, you can also have a column that you hide/show based on a condition

3.8.0

In grid slide module for pptx, add possibility to loop over a given value.

3.7.4

Bugfix Cannot read property 'map' of undefined when having data: [] without any fixedColumns.

3.7.3

Bugfix for Cannot read property 'getAttribute' of undefined when having styles without names.

3.7.2

For Vertical Table module, the generated document was corrupt when having tables inside tables. This is no more the case

3.7.1

Do not add <w:spacing> tag if it is already present (fixes setting the spacing on the paragraph to change spacing of each paragraphs in the table).

3.7.0

Add support for finalPageBreak (default false), and stop inserting page breaks every time.

Add support for newlines (with \n) in data, header, subheader.

3.6.1

Add support for indent parameter to offset the table

3.6.0

Add support for table grid functionality when using this module together with the slides module.

3.5.4

Allow to have data: [] to show only a header.

3.5.3

Keep same font-size of text in {:table table1}

3.5.2

• Update browser build to use XMLSerializer instead of xmldom

• Use requiredAPIVersion

3.5.1

Add option border : { type: "all"} to force to have borders.

Fix bug totalWidth float

3.5.0

Add possibility to specify totalWidth, for example totalWidth: 700 or totalWidth: '100%'.

Add table grid module using : {:#grid user} and {:/grid}

3.4.4

• Move docxtemplater from devDependencies to dependencies

Explanation : On some versions of npm (notably 5.8.0), when having a package containing docxtemplater-table-module, the installation will generate a tree of node_modules that puts the module on a level where it has no access to docxtemplater. By explicitly asking it as a dependency, this issue is avoided.

3.4.3

Make it possible to not have a subheader (header without subheader)

3.4.2

• Make module compatible with docxtemplater version 3.5 and below.

Explanation : Recently, the scopemananger API (internal API) has changed, this new version of the footnotes module makes the module work with both versions newer than 3.6 and older than 3.6 of docxtemplater.

3.4.1

Add meta context argument to custom parser with information about the tag for each types of tags

3.4.0

For Full Table module, add possibility to add function in constructor to be able to customize the default spacingAfter property (eg for example, remove any default options).

3.3.1

For Full Table module, use style and properties of current paragraph for each cells in the paragraphs.

3.3.0

For Full Table module, Add possibility to :

• set the alignment with the align option

• set options global to each table in the constructor

3.2.3

For Full Table module, make all parameters except data optional.

3.2.2

Handle vertical tables that have different amount of columns. For example :

3.2.1

Make generated docx not contain unnecessary commas

3.2.0

Add support for vertical table

3.1.3

• Add table style only if needed

3.1.2

• Fix other .forEach when last table is empty.
• Fix height calculation, that doesn't take into account the height of the vertical cells

3.1.1

The headerSize is now calculated and taken into account when chunking.

Fix .forEach bug : If the dataset contains a cell that would not fit in the table because it is too high, the module will still put it in there since it cannot be splitted

3.1.0

Add support for dynamic chunkSize.

You can write :

const opts = {
    chunkSize: {
        type: "dynamic",
        size: { min: 7000, max: 8100 },
    },
};

3.0.0

Initial release