| An HTML form, which will enclose other components to render out the various types of fields.
A Form emits several notification events; when it renders it sends a
Form.PREPARE prepare notification event, to allow any listeners to set up the state of the page prior to rendering out
the form's content.
When the form is submitted, the component emits four notifications: first another prepare event
to allow the page to update its state as necessary to prepare for the form submission, then
(after components enclosed by the form have operated), a "validate" event is emitted, to allow
for cross-form validation. After that, either a "success" or "failure" event (depending on
whether the
ValidationTracker has recorded any errors). Lastly, a "submit" event, for any
listeners that care only about form submission, regardless of success or failure.
For all of these notifications, the event context is derived from the context
parameter. This context is encoded into the form's action URI (the parameter is not read when the
form is submitted, instead the values encoded into the form are used).
|