Version dev

# `Paragraph`

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

## Child elements

`A`, `B`, `Barcode`, `Br`, `Clip`, `Color`, `Fontface`, `ForAll`, `Frame`, `HSpace`, `I`, `Image`, `Initial`, `Loop`, `Mark`, `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)
  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)
  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>

#### On this page