Orphaned paragraphs

The following <binding-properties/> attributes control the orphaned paragraph repositioning mode for the current element.

Where allowed

Any mapping.

Range of effect

The current element.

Attributes

avoid-orphans

Specifies if repositioning rules may be applied when rendering orphaned paragraphs within the context of the current element.

The permitted values are:

  • yes — TopLeaf is permitted to reposition orphaned paragraphs when rendering the content of any page.

  • input-changed — TopLeaf is only permitted to reposition orphaned paragraphs when rendering the content of input changed or manually included leaves.

  • no — TopLeaf is not permitted to reposition orphaned paragraphs. This is the default.

It is recommended that orphaned paragraph repositioning be enabled within specific element contexts, such a list or a breakable boxed region.

groupid

Specifies a group identifier assigned to all paragraphs rendered within the context of the current element. TopLeaf will use the identifier to determine when the last in a group of paragraphs is an orphaned paragraph. If not specified the group identifier is derived from the tag context path defined when a paragraph is formatted.

This option is ignored if orphaned paragraph repositioning rules are not enabled.

Some constraints may be applied when repositioning orphaned paragraphs. These are declared in the $document mapping using the <page-properties/> command.

Examples

The following examples show how to minimise the occurrence of orphaned paragraph content.

To minimise the occurrence of orphaned <item> blocks contained within a <list> block, declare the following command in the <list> start tag customisation:

<binding-properties avoid-orphans="yes" />

To minimise the occurrence of any orphaned paragraph rendered within a <sect3> block, declare the following command in the <sect3> start tag customisation:

<binding-properties groupid="sect3" avoid-orphans="yes" />