XForms Essentials

Name

The xforms-value-changed Event

Synopsis

Event type: notification

Event target element: form control

Bubbles: Yes

Cancelable: No

This event serves as a notification that the value that a form control is displaying is due for a change. This normally happens at the point where the user navigates away from a changed control, since only then is it known that the user has finalized her choice. In this respect, xforms-value-changed is much like the onchange event from HTML.

It’s also possible, however, for a form control to send additional xforms-value-changed events while the user is still interactively typing, clicking, dragging, or speaking to produce a value. In order for these extra events to be generated, the attribute incremental on the form control needs to have the value true.^[3]

^[3] For the select and select1 form controls, incremental="true" is the default, so the extra events will normally be dispatched as the selection interactively changes.