@gquagliano/jspdf-textbox v1.3.0

jsPDF TextBox

Rich text boxes for jsPDF.

This library lets you:

• Add rich text to your jsPDF documents, using a syntax similar to Markdown.
• Create text boxes with horizontal/vertical overflow control, and page breaks.
• Compute text boxes dimensions, useful to arrange other document elements relative to the text (like backgrounds).

Usage

Install

npm i @gquagliano/jspdf-textbox

Usage

import  jsPDF  from  "jspdf";
import textBox from "@gquagliano/jspdf-textbox";

let doc = new jsPDF();

let myTextBox = new textBox(doc, "**Hello** World", {
	//options
});

//In case you need the text box dimensions before actually drawing it:
//myTextBox.pages - Number of pages used up by the text box
//myTextBox.finalY - Final Y position (last page)
//myTextBox.finalHeight - Height of the text box (last page)

myTextBox.draw();

Supported formats

• **bold**
• *italic*
• ***bold italic***
• _underlined_
• # Heading 1 (block)
• ## Heading 2 (block)
• > Centered paragraph (block)
• >> Right-aligned paragraph (block)
• <> Justified paragraph (block)
• Fill with spaces in between (four spaces, only if the box/block is justified)
• < Left-aligned paragraph (block)
• ^ Small text (block)
• Escape character: \

Note: "block" means that the token formats whole lines (until line break or end of input), and it must be located at the begining of the line.

Note: You can use one single escape character in front of a string of all the same character, for example: \_______ will print the entire line _______ instead of escaping just the first underscore.

Options

Styles

Only a couple of styles are supported so far.

Supported styles:

• fontSize
• bold (boolean)
• italic (boolean)
• underline (boolean)
• marginBottom
• lineHeight (line height factor)

Note: Paragraph style will be the document's text style at the moment of drawing. Font face, size and leading should not change between the textBox instance creation and the execution of draw().

Note: Styles reset for each block/paragraph.

TODO

1. Add more formatting tokens, including colors, links and images--or full Markdown support.
2. Add validations & friendly error messages.
3. Columns.
4. Hyphenate.
5. Position the box relative to the bottom margin of the page.
6. Test! The current version is a work in progress, use it at your own risk.