JavaScript API: removeVariableImage

CONTENTS

LAYOUTS

SETTINGS

STYLES

TEMPLATES

OTHERS

removeVariableImage

PREMIUM

TRIAL / ADVANCED

Removes image variables.

Note

You are reading the JavaScript API documentation. For the PHP API method please go to removeTemplateVariableImage.

Description

removeVariableImage (variables: string[], target: Target = "document", options: OptionsRemoveVariableImage = {}): this

type Target =
    | "document"
    | "header"
    | "footer"
    | "comment"
    | "endnote"
    | "footnote";

interface OptionsRemoveVariableImage
    extends OptionsFirstMatch,
        OptionsReplacementType {}

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

interface OptionsReplacementType {
    /** Remove type: inline, block. Default as inline  */
    type?: "inline" | "block";
}

Code samples

Example #1

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

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

const docx = new CreateDocx();
// load the template
docx.openTemplate(docxTemplate).then(docx => {
    // variables to be removed in the document
    const variablesDocument = ["IMAGE_1"];
    // remove template image variables in the document target
    docx.removeVariableImage(variablesDocument);

    // variables to be removed in the header target
    const variablesHeader = ["HEADERIMG"];
    // remove template variables in the header target
    docx.removeVariableImage(variablesHeader, "header");

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

The resulting Word document looks like:

Release notes

phpdocx 15.0:
- new method.