XFA Specification
Chapter 15, Template Specification
Template Reference
455
1
Always start a new layout container.
The target property
The value of this property is either a SOM expression (which can not start with '#') or a '#' followed by an
XML ID. The SOM expression or XML ID points to a layout container which may or may not be the current
layout container. When this property is empty or blank layout continues in the existing container.
Note that this replaces the
afterTarget
attribute on the deprecated
break
element.
The targetType property
Controls movement to new a layout container after laying out the content of the parent object.
auto
Layout continues using the current layout container.
contentArea
Layout transitions to the next available content area.
pageArea
Layout transitions to a new page.
Note that this replaces the
after
attribute on the deprecated
break
element.
The trailer property
The value of this property is either a SOM expression (which can not start with '#') or a '#' followed by an
XML ID. The SOM expression or XML ID points to a subform or subform set to be laid down after the
content of the parent object but before any other actions of the break such as transitioning to a new page.
When this property is empty or blank no trailer is laid down.
The use property
Invokes another object in the same document as a prototype for this object. The content of this property is
either a SOM expression (which cannot start with '#') or a '#' character followed by an XML ID.
Starting with XFA 2.4 the object used as a prototype no longer needs to be the child of
proto
. Any object
of the appropriate class can be used as a prototype.
If both
use
and
usehref
are non-empty
usehref
takes precedence.
The usehref property
Invokes an external object as a prototype for this object. The content of this property is an URL, followed
by '#', followed by either an XML ID or by som(SOM_expr) where
SOM_expr
represents a SOM expression.
The XML ID or SOM expression is resolved in the context of the external document.
If both
use
and
usehref
are non-empty
usehref
takes precedence.