replaceVariableWordMl

Replaces text variables with WordML.

Description

replaceVariableWordMl (variables: Map, target: Target = "document", options: OptionsReplaceVariableWordFragment = {}): this 
type Target =
    | "document"
    | "header"
    | "footer"
    | "comment"
    | "endnote"
    | "footnote";

interface OptionsReplaceVariableWordMl extends OptionsFirstMatch {}

interface OptionsFirstMatch {
    /** Replace only the first match. Default as false */
    firstMatch?: boolean;
}

Code samples

Example #1

import { CreateDocx, WordFragment } from "build";
import * as fs from "fs";

const docxTemplate = fs.readFileSync("template.docx").buffer;

const docx = new CreateDocx();
// load the template
docx.openTemplate(docxTemplate).then(docx => {
    const wordMlFragment = new WordFragment();
    wordMlFragment.addWordMl(
        'This is a simple paragraph with some bold text.'
    );

    // variables to be replaced
    const variablesDocument = new Map();
    variablesDocument.set("VARNAME", wordMlFragment);

    docx.replaceVariableWordMl(variablesDocument);

    // save the DOCX
    docx.save().then(contents => {
        fs.writeFileSync("replaceVariableWordMl_1.docx", Buffer.from(contents));
    });
});

The resulting Word document looks like:

Download example document

Release notes

  • jsdocuments 1.0:
    • New method