XFA Specification
Chapter 12, User Experience
Widgets
350
open="multiSelect"
). Otherwise, the choice list is hidden until the user selects or otherwise enters the
field.
The choice list element may provide a default value, as does
Example 12.1.
If the choice list provides a
default selection, that selection is presented as though the user had selected it, as illustrated on
page 350.
User Selects Field
If the choice list is not already visible, selecting the field (or using keyboard sequences to enter the field)
causes the choice list to be come visible.
When the user selecting data items from the choice list, those items become highlighted. The highlighting
remains until another selection is made, except for choice lists that allow selection of multiple data items.
Whether the User May Select Multiple Data Values
If the choice list allows the user to select multiple data values (
open="multiSelect"
), user may select
multiple data, by holding down the shift key.
Whether the User May Provide Data Values
The choice list may allow the user to provide data values (
textEntry="1"
) property allows the widget to
specify whether the user may provide data values in place of the values provided by the choice list.
Allowing the user to supply data values changes the list of values into a list of hints or prototypes that the
user may modify.
The user may not provide data values when the choice list
open
property is set to
"always"
or
"multiSelect"
, regardless of the value of
textEntry
.
User Exits Field
When the user exits the field (by pressing the enter key, tabbing out, or selecting another field), the choice
list reverts to its original presence (where choices are revealed or hidden); however, the selected data
remains visible. In the case of choice lists having hidden choices, the chosen value appears in the field; and
in the case of choice lists having revealed values, the chosen value or values remain highlighted.
Choice list appearance after selecting data and then exiting the field
wheat
rye
A choice list whose list is hidden when
not selected.
A multi-select choice list for which
multiple items are selected. Such a
list is always revealed.