Paragraph

Insert a paragraph of text. The width of the paragraph is inherited from the surrounding element.

Child elements

A, Action, B, Barcode, Br, Clip, Color, Fontface, ForAll, Frame, HSpace, I, Image, Initial, Loop, NoBreak, Span, Sub, Sup, Switch, U, URL, Value

Parent elements

Case, ForAll, Function, Loop, Otherwise, SetVariable, Td, Text, Textblock, Until, While

Attributes

actualtext (text, optional, since version 4.19.23)

Set the text for screen readers.

allowbreak (text, optional)

(Experimental!) list of characters where a line break is possible. Space character is not implied when this attribute is set.

bidi (optional, since version 4.1.14)

Analyze direction of the text. Useful for mixing left-to-right and right-to-left text.

yes

Analyze text.

no

Don’t handle mixed directions (default).

class (text, optional)

CSS class for this paragraph.

color (text, optional, CSS property: color)

Color of the paragraph. Must be defined with DefineColor before use.

direction (text, optional, since version 4.1.12)

The text direction (ltr or rtl)

font-outline (length, optional, since version 4.13.15)

Set the line width of the font outline.

fontfamily (text, optional, CSS property: font-family)

The name of the font family for the paragraph. The default is »text« (lowercase t).

html (optional, since version 4.1.2)

Set the HTML processing mode. Defaults to 'all'.

all

Interpret HTML starting from the current element.

inner

Ignore the name of the outer element.

off

Switch off HTML in this paragraph. Use only the text value.

id (text, optional)

CSS id for this paragraph.

label-left (text, optional, since version 4.1.4)

A text to the left of the paragraph.

label-left-align (optional, since version 4.1.4)

Alignment of the text.

left

Left aligned

right

Right aligned

label-left-distance (length, optional, since version 4.1.4)

Horizontal distance between text and paragraph (if right aligned).

label-left-width (length, optional, since version 4.1.4)

Width of the text.

language (optional)

Name of the language for hyphenation and rendering.

padding-left (length, optional, since version 3.9.27)

Set the left padding, i.e. the inner distance to the allocated area.

padding-right (length, optional, since version 3.9.27)

Set the right padding, i.e. the inner distance to the allocated area.

parent (text, optional, since version 4.19.8)

The id of the parent structure element for tagged PDF. If left empty, the software tries to derive the parent id from the layout structure.

role (optional, since version 3.5.7)

The role for PDF/UA (accessibility, tagged PDF)

structpos (top, cur or number, optional, since version 4.19.23)

Set the position of the tag in the structure hierarchy for PDF/UA. Default is 'cur', which inserts the element at the current position (the current “bottom”). 'top' (or 1) inserts the element at the beginning of the structure. Use any other number to control the insertion.

textformat (text, optional)

Name of the textformat that is applied to the paragraph. If none is specified the textformat text is used.

Example

<Textblock>
  <Paragraph fontfamily="Title">
    <Value>Hello World</Value>
  </Paragraph>
</Textblock>

See also

The section text formatting and the command Options for a list of all languages.