CHANGELOG

3.5.2

If putting an HTML tag inside a loop, keep the HTML tag as block if there is no content except for the loop start.

Show warning if trying to import multiple links in one cell (this is not possible because of an excel limitation).

Correctly render multiple links if using horizontal loop

The xlsx module version 3.34.1 or higher is required to make this version work.

3.5.1

Fix stacktrace when having inline html tag that returns a non-string (now, it is automatically first converted to a string).

3.5.0

This version needs the xslx-module version 3.34.0 or higher.

If your data returns something that is not a string, the HTMLXlsx Module will call the XlsxModule, which allows you to render Dates or other types with the HTMLXlsx Module.

Add support for onInvalidBlock: "inline" which will automatically convert a block tag to an inline tag if the context does not allow a block tag.

With this template :

The {~~html} block tag is normally not allowed inside an inline loop, if you set onInvalidBlock: "inline", the module will transform the html tag to an inline tag.

Use it like this :

const HTMLXlsxModule = require("docxtemplater-html-xlsx-module");
const XlsxModule = require("docxtemplater-xlsx-module");
const doc = new Docxtemplater(zip, {
    paragraphLoop: true,
    linebreaks: true,
    modules: [
        new XlsxModule(),
        new HTMLXlsxModule({
            onInvalidBlock: "inline",
        }),
    ],
});
doc.render({
    name: "<b>John</b>",
});

If you set the same prefix for block tags and for inline tags, the option onInvalidBlock: "inline" is automatically set.

3.4.0

Add support for html-inline tag (requires xlsx module 3.33.0).

Fix error that was thrown when an html tag is on a cell that has no style specified.

Fix error when passing non-string value to the html-xlsx module.

3.3.1

Bugfix error when using following input :

doc.render({
    html: `
        <p>A B C</p>
        <p></p>
        <p>DEF</p>
        <p></p>
        <p></p>
        <p>G HI</p>
    `,
});

The following error was shown :

Now this error has been fixed

3.3.0

Verify that all options specified in the module's constructor are valid by ensuring the types are accurate, using Minizod, a library akin to Zod for type verification.

3.2.10

Use new internal xmlContentTypes API (requires docxtemplater 3.55.1 or higher)

3.2.9

Make this module compatible with xlsx module 3.29.2 and above

3.2.8

In very rare cases, the html-xlsx module could produce output that would show an error message when opened with Excel. This requires version 3.27.5 of the xlsx module.

This version now produces correct documents.

3.2.7

Make it possible to use prefix from the constructor

3.2.6

Add typescript typings to be able to change the module prefix

3.2.5

Bugfix to allow to mix together <ol> tags together with <u>, <b> tags.

Previously, the following would result in an error :

doc.render({
    html: `
                <u>Underline</u> Foobar <b>strong</b>
                <ol><li>Todo</li><li>Foobar</li></ol>
                <br>
                <p>X Y Z</p>
                <br>
                <p>O M P</p>
                <ul>
                    <li>Zoo</li>
                    <li>Bax</li>
                </ul>
                <br>
                <br>
                Zaza
   `,
});

It now renders correctly the complete content.

3.2.4

The fix which was theoretically fixed in version 3.2.3 was still present.

The complexity was still O(n²) because the following was used :

// simplified code
const relsDoc = {}; // ...
const links = []; // links will be "https://ddg.gg", ...
function addLink(link) {
    const relationships =
        relsDoc.getElementsByTagName("Relationships")[0];
    const child = relsDoc.createElement("Relationship");
    child.getRelationFromLink(link);
    relationships.appendChild(child);
}
for (let i = 0, len = links.length; i < len; i++) {
    addLink(links[i]);
}

getElementsByTagName is called for each iteration of the loop.

Since getElementsByTagName() needs to check each node in the XML, the more nodes there are, the more time this function takes.

It makes more sense to get the relationships object outside of the addLink function (which then acts as a sort of cache).

Adding 10000 links should take about 2.5 seconds now.

3.2.3

When using the HTML tag and inserting links, there was a performance issue when adding over 1000 links in a document.

The more links you added, the slower it got.

This is now fixed, and the time spent should be proportional to the number of links added (10000 links should still take about 2 seconds). Previously, adding 10000 links could easily take 30 seconds.

3.2.2

• When including the module using webpack, throw specific error if cssParser could not be loaded.

See this Create React App issue and this @adobe/css-tools issue.

3.2.1

Add support for <figure> and <figcaption> tag (which renders exactly like a div).

3.2.0

Make it possible to style the full cell : border, text-align, background-color;

3.1.11

Bugfix when using special characters in links.

Previously, the following code would produce a corrupt document :

const HTMLXlsxModule = require("docxtemplater-html-xlsx-module");
const XlsxModule = require("docxtemplater-xlsx-module");
const doc = new Docxtemplater(zip, {
    modules: [new XlsxModule(), new HTMLXlsxModule({})],
});
doc.render({
    html: "<a href=\"https://ddg.gg/&gt;''\">&lt; && \"DDG' & &gt; XXX</a>",
});

Now the generated document is valid.

3.1.10

Upgrade module to use NodeNext moduleResolution setting. See explanation here

3.1.9

Bugfix issue when having tag inside "sheetname" (a normal tag, not an HTML tag). The value shown would simply be "true".

3.1.8

Use new resolvedId API => requires docxtemplater@3.43.0

3.1.7

Add support for setting ignoreUnknownTags:true

3.1.6

Fix bug when using renderAsync and parser compilation fails : the error should now be shown inside a multierror. To to this, we know use sm.getValueAsync in resolve instead of sm.getValue

3.1.5

Set module.priority in order to have no more issues related to module ordering

3.1.4

Bugfix issue when using expand horizontal loop in xlsx :

3.1.3

Bugfix issue when using loop module with HtmlXlsxModule enabled, the following template :

Would produce :

In async mode :

In sync mode :

3.1.2

Add module.clone() internal

3.1.1

Bugfix when passing in empty string : "" or blank string : " ".

Previously, the following error was thrown :

3.1.0

Add support for :

• <ul>, <ol>, and <li>
• <br>
• font-size: 15px
• color: #770

Bugfix for <strong>, <em>, <i>, <u>.

3.0.0

Initial release