Tag name: <amc:panelGroupLayout>
The panelGroupLayout component is a layout element that arranges its children in one of two patterns. It can lay out children in a single horizontal line or vertically.

This component supports scrolling. Set horizontalScroll or verticalScroll to "true" to enable horizontal or vertical scrolling, respectively. Note that both attributes are set to false by default. The panelGroupLayout does not support flow layouts or the stretching of its child components.

Due to the limited display area on mobile devices, it is not advisable to have several nested scrolling containers. Instead, it is preferable to enable scrolling on a single top level container.

WM panelGroupLayout screenshot
A panelGroupLayout component running on Windows Mobile with horizontal layout.

BB panelGroupLayout screenshot
A panelGroupLayout component running on BlackBerry with horizontal layout.

<amc:panelGroupLayout layout="horizontal" id="pgl1">
    <amc:spacer width="10" height="1" id="s1"/>
  <amc:commandLink text="oracle1" destination="http://www.oracle.com" id="gl1"/>
  <amc:commandLink text="oracle2" destination="http://www.oracle.com" id="gl2"/>
  <amc:commandLink text="oracle3" destination="http://www.oracle.com" id="gl3"/>
</amc:panelGroupLayout>

Attributes

Name Type Supports EL? Description
align String Yes Specifies the horizontal alignment of an element with respect to the surrounding context. Valid values:
  • left (default): the component is rendered flush left.
  • center: the component is centered horizontally.
  • right: the component is rendered flush right.
The attribute is ignored and defaulted to left when the parent Panel Group Layout has a horizontal layout.

Note: On BlackBerry smartphones, if the attribute value is assigned by an EL expression, any changes to the value will not affect the visual appearance of the element once it is rendered.
backgroundColor String Yes Sets the color of a background to an RGB value (rgb(255,0,0)) or a hexadecimal number (#ff0000 or #f00). The default value is device-dependent.
height int Yes Specifies the height of the component. Can be entered in pixels or as a percentage of its parent's height. A percentage value should be entered as a number followed by the "%" symbol. A number will be interpreted as a pixel value (as will a number followed by the text "px").
horizontalScroll boolean Yes Specifies whether or not this component can scroll horizontally.
id String No Specifies the identifier for the component. The identifier must follow the following rules:
  • Must not be a zero-length String.
  • First character must be an ASCII letter (A-Za-z) or an underscore ('_').
  • Subsequent characters must be an ASCII letter or digit (A-Za-z0-9), an underscore ('_'), or a dash ('-').
layout String Yes Specifies the type of layout. Valid values:
  • horizontal: strictly consecutive without wrapping. In a horizontal layout, the child components can be aligned vertically. By default, child components are top aligned.
  • vertical (default): vertically stacked. In a vertical layout, the child components can be aligned horizontally. By default, child components are left aligned.
rendered boolean Yes Specifies whether or not the component is rendered. When set to false, no output will be delivered for this component (the component will not in any way be rendered, and cannot be made visible).
verticalAlign String Yes Specifies the vertical alignment of a component with respect to the surrounding context. Valid values:
  • top: the component is rendered flush top.
  • middle: the component is centered vertically.
  • bottom: the component is rendered flush bottom.
This attribute is ignored and defaulted to top when the parent Panel Group Layout has a vertical layout.

Note: On BlackBerry smartphones, if the attribute value is assigned by an EL expression, any changes to the value will not affect the visual appearance of the element once it is rendered.
verticalScroll boolean Yes Specifies whether or not this component will scroll vertically.
width int Yes Specifies the width of this component. Can be entered in pixels or as a percentage of its parent's width. A percentage value should be entered as a number followed by the "%" symbol. A number will be interpreted as a pixel value (as will a number followed by the text "px").