formErrorText Macro
Syntax
{addedValueMacros.formErrorText (formid, formListPrefix, formItemPrefix, formItemSuffix, formListSuffix, elementListPrefix, elementItemPrefix, elementItemSuffix, elementListSuffix)}
- formID - the name of a form whose errors are to reported
- formListPrefix (optional, default "<ul>") html to insert before the list of form elements with errors
- formItemPrefix (optional, default "<li>") html to insert before each form element with an error
- formItemSuffix (optional, default "</li>") html to insert after each form elemnt with an error
- formListSuffix (optional, default "</ul>") html to insert after the list of form elements with errors
- elementListPrefix (optional, default "<ol>") html to insert before the list of errors for one form element
- elementItemPrefix (optional, default "<li>") html to insert before each error of one form error
- elementItemSuffix (optional, default "</li>") html to insert after each error of one form error
- elementListSuffix (optional, default "</ol>") html to insert after the list of errors for one form element
Examples
| {addedValueMacros.formErrorText("myEntryForm")} |
If there were 1 form field with errors, elemA with 2 error messages, the above call might return
<ul>
<li>elemA
<ol>
<li>text of first error message</li>
<li>text of second error message</li>
</ol>
</li>
</ul>
Semantics
Returns a string layout of any validation errors from the last submission made to the form called
formID. If there were no errors, returns an empty string. The remaining parameters determine the look and feel of the response.
This macro is generally used in form layouts.
See also