Form Validation Settings
In Form Validation Settings, you set properties that apply to the entire form. You can configure the type of form-level validation, choose to display a red asterisk beside all mandatory fields, and specify the display position for error messages.
Form Validation Basics video
These are different from the properties that relate to an individual field that are configured in Field Validation settings.
In Form Designer, you access the Form Validation Settings panel by clicking on the form name in the Form Outline Panel in the upper left corner, then choosing Form Validation Settings in the lower left corner.
| Property | Details |
|---|---|
| Enabled | Default is true. Validation is turned on. Validation is generally recommended, but it can be useful to disable it if you are testing your form and want to skip all validation. For multi-page forms, disabling validation can help you test conditional branching without completing the form. |
| Validation Mode | How and where to display the validation error messages when a form is submitted. Default is Dynamic (Show inline errors, or use the lightbox validation mode). Change to Classic Mode (Errors shown in a basic pop-up window) or None (Small error icons will appear near the element containing the error. When the user hovers over these small icons, any text in the Custom Message property of the element will appear in a red tooltip. If the Custom Message property is empty, only the small red icons will indicate the validation error.) |
| Message Position | Where the main error message should be shown. Default is Inline/Top ( Top of the form, just below the header.) Change to Inline/Bottom (Bottom of the form, just above the buttons.), Inline Custom Position (Display at a user-determined position on the form. After selecting this option, you can position an error marker at any position on your form. The error message will appear at this location), or Float (Display the Error Message in a modal dialog window floating above the form. A mask/overlay is shown over the form and an error message appears within it.) |
| Message Width | Recommend you leave at Auto. If you are placing the error message in a container and the layout is not working, set the message width in pixels. |
| Message Style | Default is true. |
| Include Details | Default is false. A message is shown iondicating the number of fields with errors, but the dtails are not shown. Change to true if you want to include the details of each validation error in the validation message. |
| Auto Update | Default is true. Automatically update the displayed validation message as fields are updated and are no longer invalid. |
| Show Asterisk | Default is false. Change to true if you want to show an asterisk next to the field caption to indicate a mandatory field. |
| Highlight on Error | Default is true. Show a red border around fields with validation errors. Change to false to disable. |
| Caption Highlight | Default is true. On validation error, change the field caption text to red. Change to false to disable. |
| Show Error Icon | Defaiult is true. Show an icon next to the field to indicate that the field has a validation error. The icon fades when the error is fixed. |
| Scroll on Error | Default is Top of Page. Where you want to scroll to on a validation error. Can also choose First Error or No Scroll from the dropdown list. |
| Show Error Tooltip | Default is true. Show a tooltip message with the validation error. |
| Error Tip Event | Default is Rollover & Focus. Decide when the error tooltip message should be shown. Can also choose Field Focus or Always Shown from the dropdown list. |
| Error Tip Position | Default is Left. Decide where the error tooltip message should be positioned relative to the field or error icon. Can also choose Above or Below from the dropdown list. |
Have more questions? Submit a request
Please sign in to leave a comment.
0 Comments