Text Box

Similar Text Frames, but the difference being that it is VML Shape based.

Text Boxes requires an understanding of Paragraphs.

Text boxes are paragraphs of text in a document which are positioned in a separate region or frame in the document, and can be positioned with a specific size and position relative to non-frame paragraphs in the current document.

Intro

To make a Text Box, simply create a Textbox object inside the Document:

new Textbox({
    alignment: "center",
    children: [
        new Paragraph({
            children: [new TextRun("Hi i'm a textbox!")],
        }),
    ],
    style: {
        width: "200pt",
        height: "auto",
    },
});

Paragraph Options

Besides style, a Textbox accepts all Paragraph options (alignment, spacing, indent, numbering, etc.). These are applied to the paragraph that anchors the text box in the document flow. For example, alignment: "center" in the example above centers the box on the page.

Style Options

The style object describes the VML shape itself. width is required; all other properties are optional.

Length values (LengthUnit) can be a number, a measurement string such as "200pt" or "50%", or "auto".

Positioned and rotated example

new Textbox({
    children: [
        new Paragraph({
            children: [new TextRun("I float above the page!")],
        }),
    ],
    style: {
        width: "150pt",
        height: "50pt",
        position: "absolute",
        left: "100pt",
        top: "40pt",
        rotation: 15,
        zIndex: 10,
        wrapStyle: "none",
    },
});