CHANGELOG

3.11.0

Add support for onInvalidBlock: "inline" in order to allow a block tag such as {~~html} to be handled as an inline tag (like {~html}) if there is some text on that same paragraph.

onInvalidBlock can be set to "inline", "block", or "error" : "error" is the default value.

3.10.0

Enhance the capability to define table cell width in pixels.

In the past, the following code would lead to a very narrow first column:

<style>
    th.first,
    td.first {
        width: 200px;
    }
</style>
<table>
    <tr>
        <th class="first"></th>
        <th>2022</th>
        <th>2023</th>
        <th>2024</th>
    </tr>
</table>

3.9.1

When placing a {~~~html} tag inside a table, that uses some table style, the generated output will now also use the same table style.

3.9.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.8.1

Fix positioning of generated part if the part contains some <a:extLst><a:ext>. This was quite rare and happened if you put the {~~~tag} inside a table, which is usually not recommended.

3.8.0

Add support for CSS style padding-top, padding-bottom, padding-left, padding-right for table cells.

Bugfix regression of misplaced HTML result when using p:cxnSp (Connection shape)

3.7.3

Add support for CSS style color on <table> elements. In previous versions, it was supported only on <td> elements.

3.7.2

Update to correctly handle numbers for data passed to the html module.

Previously, the following would trigger a stacktrace because the html data was not a string :

const doc = new Docxtemplater(zip, {
    paragraphLoop: true,
    linebreaks: true,
});
doc.render({
    html: 33,
});

Now, the data is first transformed into a string, then interpreted.

3.7.1

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

3.7.0

Improve support of lists : we correctly will use the style from the bullets defined in the master slide if a style is defined there.

Add support for CSS property : -dx-list-start-level: 1 : this will use the lvl="1" as the start level for HTML lists. The default is 0.

Add support for customizing the bullet for your lists using list-style-type.

We're simplifying our CSS custom property prefix from -dxt- to -dx- while maintaining backward compatibility.

Changes

• Old prefix: -dxt- (still supported)
• New prefix: -dx- (now preferred)

Examples

Previous:

ul li {
    -dxt-bullet-indent: 1in;
    -dxt-bullet-spacing: 1in;
}

Preferred:

ul li {
    -dx-bullet-indent: 1in;
    -dx-bullet-spacing: 1in;
}

Migration

• Use -dx- for all new code
• Existing -dxt- code will continue to work
• Update old code gradually when convenient

For bulk updates, find -dxt- and replace with -dx-.

3.6.3

• Fix corruption when havingtag

3.6.2

• Add support for text-decoration-color (on normal text or links) to customize the underline color.

• Improve support for star selector.

3.6.1

Make it possible to use prefix from the constructor

3.6.0

Add support for :

• the <mark> tag to highlight text in yellow
• background-color set on text
• calling nullGetter if the value of the data is nullish

3.5.11

Bugfix of a corruption, when using a {~html} tag that itself is a link, the output document could get corrupted.

It now works correctly.

3.5.10

Add typescript typings to be able to change the module prefix

3.5.9

When having a loop with an inline HTML tag inside it, the following error would sometimes appear :

This error should no more appear, the document should generate correctly now.

3.5.8

Allow to change text color of links using following cod :

const HTMLPptxModule = require("docxtemplater-html-pptx-module");
const doc = new Docxtemplater(zip, {
    modules: [
        new HTMLPptxModule({
            styleSheet: `
                a {
                    color: #f3a;
                }
            `,
        }),
    ],
});
doc.render({
    html: '<a href="https://docxtemplater.com">link</a>',
});

3.5.7

Fix regression : correctly template slideMaster and slideLayout files (if some {placeholders} are present in the slideMaster, those will now be correctly templated).

3.5.6

Add support for vertical-align: bottom (or middle, top).

3.5.5

• 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.5.4

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

3.5.3

Upgrade module to use NodeNext moduleResolution setting. See explanation here

3.5.2

Bugfix to set or get xml attributes correctly, even when using tabs instead of spaces in tags attributes

3.5.1

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

3.5.0

Add initial support for tables.

To add a table, you need to use a tag with three ~, like this :

const HTMLPptxModule = require("docxtemplater-html-pptx-module");
const doc = new Docxtemplater(zip, {
    modules: [
        new HTMLPptxModule({
            styleSheet: `
                    tr td,tr th {
                        border-top: none;
                        border-left: 6px solid orange;
                        border-bottom: 4px dashed orange;
                    }
                `,
        }),
    ],
});
doc.render({
    html: `
    <table>
        <tr>
            <td>Hello</td>
            <td>Foo</td>
        </tr>
    </table>
`,
});

This initial version supports the following :

• colspan and rowspan
• background-color
• border using the stylesheet option

3.4.4

Add module.clone() internal to make module work well with subsegment module

3.4.3

Bugfix issue when having {~~html} as the title :

The following error was thrown :

Now, the generation happens (no stacktrace thrown).

3.4.2

Add support for margin-left or padding-left on paragraph element.

3.4.1

Correctly keep font-family of existing text used in the {~~html} tag.

Previously, the font-family was lost.

3.4.0

Add support for inline html tag using {~html} (block tag is with {~~html}).

Rename property this.prefix to this.blockPrefix.

3.3.1

Bugfix "Cannot read properties of undefined (reading 'forEach')", when using stylesheet with comments.

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

Bugfix issue : TypeError: Cannot read properties of undefined (reading 'getElementsByTagName') in `getSlideLayoutPath when using together with the slides module.

3.2.4

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

3.2.3

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

3.2.2

Add typescript definitions for public API

3.2.1

When specifying a color with CSS, in previous versions, if the text containing the {~~html} tag was colored with a theme, the document could be corrupted.

This release fixes the bug, the color is now the right one.

3.2.0

Better handle override of style. Includes a quite big rewrite.

For example, it is now possible to override the color of some text in a given run without producing a corruption and without losing all other formatting on that block of text.

3.1.6

Disallow to pass something other than a string to the stylesheet option (because this option only allows to pass a given global stylesheet)

3.1.5

Bugfix when using together with slides module, it would result in the following error :

Now, loops created with the slides module can contain html-pptx tags

3.1.4

Fix issue with css module :

Now, the module requires only the part that it uses, which removes this error.

3.1.3

Bugfix to ignore <br> at the end of block elements.

3.1.2

Bugfix to render space in inline HTML tag when using : <b>Foo</b> <i>Bar</i>

3.1.1

Bugfix corruption when using ul and li, sometimes, it would return a float value for spcPts

3.1.0

Add way to specify spacing between bullet and text, and indent of bullet with :

ul li {
    -dxt-bullet-indent: 1in;
    -dxt-bullet-spacing: 1in;
}

Better handle margin-top/margin-bottom for li tags

3.0.2

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

3.0.1

Add support for <u>, <sub> and <sup> tag and for style : text-decoration: underlined.

3.0.0

Initial release