mPDF Manual – HTML control tags

# annotation

(mPDF >= 2.2)

annotation – Add an Annotation to the document

## Description

<annotation  $content [$pos-x ] [ $pos-y ] [$icon ] [ $author ] [$subject ] [ $opacity ] [$color ] [ $popup ] [$file ] />

Adds an Annotation to the document. An annotation is like a Tooltip on a webpage. The Annotation marker, like those of “Sticky Notes” in Adobe Reader. When the reader passes the cursor over, it will display a popup text box.

The exact position on the page can be specified using $x and$y, or left to position automatically. If $x and$y are not specified, the Annotation will be inserted at the current position of writing in the document. The $x position (horizontal) can be overridden by the variable annotMargin, which can be used to force the Annotation marker to display in the right margin. The attribute$file can be used to specify a file (any type) which is to be embedded inside the PDF document.

Annotations cannot be moved or deleted by the reader.

## Parameters

$content This parameter specifies the text to appear in the popup text box.$content cannot contain any of the characters: < > & ‘ or “ and must use the appropriate HTML entities e.g. <annotation content=”This is &lt; 40” />

It is recommended that you use htmlspecialchars(‘Content’, ENT_QUOTES) for this.

$pos-x Sets the$x position of the (bottom left edge of the) Annotation marker, set in mm from the left of the page.

BLANK or omitted or 0 uses the current writing position on the page, unless overridden by $annotMargin.$pos-y

Sets the $y position of the (bottom left edge of the) Annotation marker, set in mm from the top of the page. When Annotation markers are used within the text (annotMargin=FALSE), the marker is raised by the current lineheight to appear above the text. BLANK or omitted or 0 uses the current writing position on the page.$icon

Sets the appearance of the Annotation marker.

BLANK or omitted uses DEFAULT i.e. ‘Note’

Values (case sensitive)

Note

Comment

Help

Insert

Key

NewParagraph

Paragraph

DEFAULT: Note

$author This specifies the name of the Author which will appear at the top of the popup text box. DEFAULT: BLANK$subject

This specifies the text to appear in the Annotation properties.

DEFAULT: BLANK

$opacity Sets the opacity of the Annotation marker. Values must be greater than 0 and <= 1. BLANK or omitted or 0: sets the opacity to the value of annotOpacity (DEFAULT 0.5), unless annotMargin forces the Annotations to appear in the margin, when the DEFAULT is 1$color

Specify the colour of the Annotation marker background.

Values

Any valid CSS color recognised by mPDF:

#RRGGBB

#RGB

rgb(255,255,255)

Named colours such as white, yellow, blue etc.

DEFAULT Yellow

$popup Specify whether to show the popup box for the annotation when the PDF document is opened, and optional specify its dimensions and/or position. BLANK or omitted or “0” - the popup box is not shown. Any other value forces the popup box to appear when the document is opened. Values <nn nn> - A string of 2 numbers (separated by spaces) will set the X and Y position in mm e.g. ‘30 30’ will show a popup box with the top left corner 30mm from the top of the page and 30mm from the left of the page. <nn nn nn nn> - A string of 4 numbers (separated by spaces) will set the X and Y position and also the width and height in mm e.g. ‘30 30 80 50’ will show a popup box with the top left corner 30mm from the top of the page and 30mm from the left of the page, a width of 80mm and a height of 50mm. Note that the PDF Reader (e.g. Adobe Reader) may reposition the popup box as it pleases.$file