XFA Specification
Chapter 15, Template Specification
Template Reference
505
The name property
An identifier that may be used to identify this element in script expressions.
The ref property
A SOM expression identifying the object which generates the event. Defaults to the object containing this
element.
This syntax requires explanation. The
ref
property points to the source of the event, not the destination
of the event. (It is a "come-from", not a "go-to".) The advantage of this is that a component can be dropped
into a template and plug itself into the events it needs to monitor.
Depending upon the value of the accompanying
activity
property, the
ref
property may point to a
subform, field, or exclusion group, to
$host
, or to a DOM such as
$layout
. See
Events
about what type of event each object can generate.
The script property
An
automation
For more information see "The
The signData property
An element controlling an XML digital signature.
For more information see "The
The submit property
An element that describes how to submit data to a host, using an HTTP POST operation.
For more information see "The
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.