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

Version

XFA 2.2

Examples

JavaScript

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

FormCalc

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

// Ethnio survey code removed