Description: A filter form to bind to a parent grid component. Supports:
JavaDoc: Click here
Remarks: These forms don't need @OnSubmit event handlers since their submit is a grid refresh. This is done automatically.
Body content: JSP context.
Attributes:
Name | Description | Data type | Required | Default value |
name | The name (identifier) of the form | String | No | Generated one in the form "formX" where X is the sequential number of forms on the current page |
title | The label for the form. Will create a field set for this | String | No | - |
cssClass | An optional CSS class to apply to the panel body. | String | No | - |
layout | Inner Fields layout. See bellow. | String | No | Pool layout |
border | Creates a default fieldset element | Boolean | No | True if a title has been defined, False otherwise |
collapsed | Defines this form to appear collapsed, when supported | Boolean | No | False |
noActions | Omit's the default action buttons generation | Boolean | No | False |
autoComplete | Enable autocomplete of the inner inputs (for safety purposes sometimes it should be disabled). | Boolean | No | True |
readonly | Activate readonly mode for all inner fields. Will also omit the submit buttons rendering | Boolean | No | False |
method | The form's submission method | String | No | post (post is mandatory if multipart forms are used |
destinationStageID | The target destination after submit | String | No | The current stage id |
cancelStageID | The target destination stage for the optional cancel action | String | No | - |
submitAction | If a submit option is available | Boolean | No | true |
saveAction | If a save option is available | Boolean | No | false |
clientValidation | Will validate submission errors in the client browser, with generated Javascript. IN DEVELOPMENT!!! | Boolean | No | False |
labelWidth | A custom width for all enclosed labels | Integer | No | As defined by the CSS in use |
helpCategory | The help category for all inner help items | String | No | The title or name of the form |
renderFootnotes | Defines if footnotes are rendered on the element. | Boolean | No | True |
confirmation | Displays a default message to confirm the form submit | Boolean | No | False, unless confirmationMessage is set |
confirmationMessage | Custom message for the confirmation message | String | No | - |
noRequiredIndicator | Disable required(*) simbol and required footnote | Boolean | No | False |
Examples:
<dif:document> <dif:form name="login"> <dif:fieldset title="${messages.pageHeading}"> <input name="afterloginstageid" type="hidden" value="${stage.afterLoginStageID}" /> <dif:textField id="_user" /> <dif:textField id="_pass" confidential="true" /> </dif:fieldset> <input type="submit" name="${messages.submit}" /> </dif:form> ... </dif:document>
Layout values: Available layouts:
See also: