XFA Specification
Chapter 15, Template Specification
Template Reference
444
The bindItems element
An element that extracts data into an item list.
<bindItems
Properties:
connection="cdata"
labelRef="cdata"
ref="cdata"
valueRef="cdata"
>
</bindItems>
The bindItems element is used within the following other elements:
field proto
This element builds the items list for a choicelist or a set of check boxes or radio buttons. However unlike
the
items
The connection property
An optional attribute that, if present, supplies the name of a connection for a web service. If this attribute is
supplied it alters the meaning of the ref property such that it is interpreted according to the same rules as
the
ref
connect
element.
The labelRef property
An optional attribute that, if present, tells where to find the data value to use as a label for each item. The
value of this property is a SOM expression which is relative to a node selected by the
ref
attribute. If this
attribute is not supplied or empty each item is labelled with its value.
The ref property
A SOM expression that selects a set of nodes, each of which corresponds to an item in the list. If there is a
connection
attribute then the value of this property is a SOM expression interpreted in relation to that
connection according to the same rules as the
ref
attribute of the
connect
no
connection
to the data node to which its containing object is bound.
The valueRef property
An attribute that tells where to find the data value for each item. The value of this property is a SOM
expression which is relative to a node selected by the
ref