commitOn

Specifies when a user’s selections are propagated to the data model.

Syntax

Reference_Syntax.commitOn = "select | exit"

Values

Type

Values

String

select
exit

The selected data is written to the data model when a user selects a choice list entry by using the keyboard or mouse.

Having a choice list commit data as soon as selections are made may be important in forms that contain non-XFA interactive features, such as Acrobat annotations or hypertext links. People filling out such forms may mistakenly believe that selecting an item from a choice list followed by clicking a non-XFA interactive feature is the same as exiting the checklist. In fact, the check list remains the field in focus.

exit

The selected data is not written to the data model until the field loses focus. This is the recommended setting for choice lists that support multiple selections (open="multiSelect").

Applies to

Model	Object
Form Model	choiceList

Version

XFA 2.2

Examples

JavaScript

DropDownList1.resolveNode("ui.#choiceList").commitOn = "exit";

FormCalc

DropDownList1.ui.#choiceList.commitOn = "exit"