XFA Specification
Chapter 15, Template Specification
Template Reference
445
The bookend element
An element controlling content that is inserted to "bookend" the contents of the parent object.
<bookend
Properties:
id="xml-id"
leader="cdata"
trailer="cdata"
use="cdata"
usehref="cdata"
>
</bookend>
The bookend element is used within the following other elements:
proto subform subformSet
The id property
A unique identifier that may be used to identify this element as a target.
The leader 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 before the
content of the parent object. When this property is empty or blank no leader is laid down.
Note that this replaces the
bookendTrailer
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. When this property is empty or blank no trailer is laid down.
Note that this replaces the
bookendLeader
attribute on the deprecated
break
element.
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.