Panel - Form Box
A panelFormBox organizes child input tags into panel (group box) where each child item consists of a label and associated field. The fields can have error messages and informational messages associated with them and the display of these messages is automatically managed. The entire panel can have a header and footer as well as a summary of the errors associated with the child items.
Properties and All Attributes views
The Properties view for a component shows the most common set of attributes you can set on a component, and, depending on the component, you might also see options for adding controls, actions, or other components. To open the Properties view, click
Window | Show View | Properties.
These common attributes for the form box component display on the hx:panelFormBox and Items tabs in the Properties view. See the Panel - Form Box attributes table for a list of attributes. Additional configuration options for panel items are on the hx:panelForm Box>Items tab:
The All Attributes view shows a table of all the attributes you can set on a component, which includes those attributes you can access from the Properties view. To switch to the All Attributes view, click the
All Attributes icon in the upper right corner of the Properties view.
Table 1. Panel - Form Box attributes Attribute name
Description
binding
An expression that binds the component's instance (usually a user interface component) to a bean property (usually in the backing file).
escape
Specifies whether to escape HTML formatting (False) or to render HTML tags as HTML (True).
helpPosition
Defines the position of help and or error text associated with all formItems contained by the panel. over and under position help/error text directly above (below) the value of the formItem (that is aligned with the left edge of the value). left and right position help/error text to the left (right) of the value.
Note: helpPosition is affected by showInPopup. If showInPopup is false, help/error text associated with each item is displayed in it's own table cell (either a row or column is added to the table to accomodate it). If showInPopup is true, the help/error text is displayed in an absolutely positioned div (that is, does not occupy an visible row/cell). Regardless of whether the text is displayed in a cell or in a div, labelPosition defines the position of the cell/div relative to the value of the formItem.
id
Assigns a name to a component. Should be a unique name within a JSP.
interItemSpacing
If provided, defines the space between each row of in the rendered table. The value may be any HTML width specification (for example, "4px", "1em", "4%"). If no width is specified, pixels (px) is used. If percent is specified, it is a percentage of the line height in force (for example, 150% means 1.5 times the line height).
Note: Spacing may also be set using the panelFormBox_Spacer-Cell class.
label
Specifies the displayed text.
labelPosition
Defines the position of labels associated with all formItems contained by the panel. over and under position labels directly above (below) the value of the formItem (that is aligned with the left edge of the value). left and right position labels to the left (right) of the value.
Note: This attribute does not affect the label attribute of the panelFormBox tag. This attribute affects the labels associated with the contained formItem tags.
rendered
Can be set to true or false:
- false - Component will not be rendered to the browser at runtime.
- true - Component will get rendered. This is the default value.
showInPopup
Defines the whether help and or error text associated with all formItems contained by the panel is displayed inline (as a table cell that causes the table to expand/contract) or as a div that is absolutely positioned relative to the form item content. The relative position (left, right, under, over) of the popup is defined by labelPosition. The popup is displayed in a higher z-order than the underlying value, it is positioned above the content.
style
Specifies CSS style information for the component (for example, style="font-size : 8pt ; color : red"). Defines the properties (such as font and color) of the selected component. This may be done manually, or by clicking the button and selecting the desired properties from within the window.
styleClass
Space-separated list of CSS style classes to be applied when this element is rendered. This value must be passed through as the class attribute on generated markup. Defines the classes (such as style sheets) of the selected component. This may be done manually, or by clicking the button and selecting the desired Classes from within the window.
title
Specifies the title text, shown in browser as a tooltip at runtime. Used by a browser as the alternative text of a component if the alternative text is not specified.
widthContent
If provided, specifies the width (either as pixels or as a percentage) of the column displaying values (content).
Note: Column width may also be set using the panelFormBox_Content-Cell class.
widthHelp
If provided, specifies the width (either as pixels or as a percentage) of the column displaying help.
Note: Column width may also be set using the panelFormBox_Help-Cell class.
widthLabel
If provided, specifies the width (either as pixels or as a percentage) of the column displaying labels. Note that the column width may also be set using the panelFormBox_Label-Cell class.