VDaemon PHP Library | VDaemon Extension | Table of Contents

VDaemon Reference
<FORM> Custom Tag

Creates a VDaemon server-side object that maps to the form HTML element and allows you creating a container for elements in a Web page.

Syntax

<form id="formId"
      method="POST"
      action="formActionPage"
      anchor="formAnchor"
      clientvalidate="true"|"false"
      populate="true"|"false|always"
      runat="vdaemon"
      disablebuttons="none"|"submit"|"all"
      validationmode="onsubmit"|"onchange">
   Other input elements, and so on.
</form>

Id Attribute

Use Id or Name attribute to define the unique identifier for the VDaemon form custom tag. Id or Name attribute is required. If both Id and Name are defined and not equal to each other, Id takes precedence.

Method Attribute

Sets how to send the form data to the server. VDaemon allows only POST method.

Action Attribute

Acts like standard HTML form action attribute.

Anchor Attribute

Adds anchor section to the form redirection URL. In case of errors VDaemon will redirect user to the following URL:

SCRIPT_NAME?QUERY_STRING#ANCHOR

ClientValidate Attribute

Determines if client-side validation will be performed. To disable client-side validation set it to false. Default value is true.

Populate Attribute

Specifies whether form elements should be filled out with a data user has entered on previous submit/validation cycle.

false - never fill out form fields.
true - fill out form fields in case of validation errors.
always - fill out form fields always when visitor returns to the form page. To use this option form data must be saved in a session (set VDAEMON_SAVE_DATA option to true in config.php file).

Default value is true.

RunAt Attribute

Set the RunAt attribute to vdaemon value to allow the form to be processed by VDaemon.

DisableButtons Attribute

Defines whether VDaemon automatically disables form buttons before sending submitted data to the web server. Can accept the following values:

None - do not disable buttons.
Submit - disable submit buttons only.
All - disable all form buttons.

Default value is none.

ValidationMode Attribute

Specifies VDaemon validation and error messaging mode. Can accept the following values:

OnSubmit - VDaemon will validate a form and display error messages after visitor clicks submit button.
OnChange - VDaemon will validate a form and display error messages after visitor changes some information on the form. This mode works only for javascript validation.

Default value is onsubmit.