fieldLayout

Description: FieldLayout component. Uses all the form capabilities but without user input. For structured data display.

JavaDoc: Click here

Remarks: All inner form components will defer to a readonly fashion with DIVs instead of INPUTs HTML tags.

Body content: JSP context.

Attributes:

Name Description Data type Required Default value
title The label for the form. Will create a field set for this String No -
layout Inner Fields layout. See bellow. String No Pool layout
cssClass An optional CSS class to apply to the panel body. String No -
border Creates a default fieldset element Boolean No True if a title has been defined, False otherwise
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

Examples:

<dif:document>
        <dif:fieldLayout>
        <dif:fieldset title="${messages.pageHeading}">
            <dif:textField id="_user" />
            <dif:textField id="email" />
        </dif:fieldset>
    </dif:fieldLayout>
    ...
</dif:document>

Layout values: Available layouts:

  • free: No layout defined. The developer will provide HTML code involving the inner tags.
  • pool: Pool layout. One label and it's field bellow. Each field bellow the previous one. Perfect for minimal width interfaces (hence the name pool) or sequential field forms.
  • tabular: The classical tabular layout. Labels on the left side, fields on the right side. The more traditional layout in web forms. Good choice for large input fields while maintaining a low page space usage as possible.
  • twocol: Similar to the pool layout, but divided in two columns of label/input pairs. It's the default and should be the option that uses less space altogether.

See also:

Back to tag reference