behavior: form

Standard behavior of the <form> element. Form is a “submitable” container. When it receives FORM_SUBMIT event from <button type=“submit”> it sends collection of name/value pairs to the server on url defined by action attribute.

that have this behavior applied by default (see master style sheet):

• <form>

that this behavior knows about:

• action=“url” - url of the cgi module (e.g. PHP or ASP page) on the server that will process values of input elements contained on the form.
• target=“frame-name” - optional, name of the <frame> that will receive response from the server.
• method=“get” | “post” - type of http request to be used for submission.
• enctype=“application/x-www-form-urlencoded” | “multipart/form-data” - type of data encoding to use for submission. Use “multipart/form-data” if the form contains <input type=file> elements.

Value of the form element is a collection of name/value pairs represented as VALUE (or json::value) of type T_MAP.

Form supports following xcall() methods (see dom::element::xcall() function):

• xcall(“submit”) - executes submit;
• xcall(“reset”) - resets all inputs to their initial values;

When the behavior:form receives BUTTON_CLICK event from <button type=submit> or <button type=reset> it generates:

• FORM_SUBMIT event - the form is about to submit form values. The values to send are in BEHAVIOR_EVENT_PARAMS::data field.
• FORM_RESET event - the form is about to restore initial values of input fields. The values that will be set are in BEHAVIOR_EVENT_PARAMS::data field.

To discard submission or clearance of the form the application shall “consume” the event - return TRUE from the event handler.