Create new RichFaces Documentation Jira issue

This will launch the RichFaces Jira page - to complete your feedback please login if needed, and submit the Jira.

JBoss.orgCommunity Documentation

6.68.  < rich:layoutPanel >

The <rich:layouPanel> is an auxiliary component used to create layout areas within the <rich:layout> container.

Table 6.338. rich : layoutPanel attributes

Attribute NameDescription
bindingThe attribute takes a value-binding expression for a component property of a backing bean
idEvery component may have a unique id that is automatically created if omitted
positionPositions the component relative to the <rich:layout/> component. Possible values are top, left, right, center, bottom.
renderedIf "false", this component is not rendered
widthSets the width of the layout area

Table 6.339. Component identification parameters

NameValue
component-typeorg.richfaces.LayoutPanel
component-classorg.richfaces.component.html.HtmlLayoutPanel
component-familyorg.richfaces.LayoutPanel
renderer-typeorg.richfaces.LayoutPanelRenderer
tag-classorg.richfaces.taglib.LayoutPanelTag

To create the simplest variant on a page use the following syntax:

Example:


...
<rich:layout>
 <rich:layoutPanel position="center">
        <!--center-->
</rich:layoutPanel>     
</rich:layout>
...

Example:

import org.richfaces.component.html.HtmllayoutPanel;

...
HtmllayoutPanel mylayoutPanel = new HtmllayoutPanel();
...

The <rich:layoutPanel> component is used to split the area inside the <rich:layout> into up to 5 parts: top, left, center, right, bottom.

The "position" attribute defines the position of the <rich:layoutPanel> in the area created with <rich:layout> .


...
<rich:layout>
    <rich:layoutPanel position="top">
        <!--top-->
    </rich:layoutPanel>
    <rich:layoutPanel position="left">
        <!--left-->
    </rich:layoutPanel>
    <rich:layoutPanel position="center">
        <!--center-->
    </rich:layoutPanel>
    <rich:layoutPanel position="right">
        <!--right-->
    </rich:layoutPanel>
    <rich:layoutPanel position="bottom">
        <!--bottom-->
    </rich:layoutPanel>
</rich:layout>
...

You can specify the width of the layout area with the "width" attribute.

On RichFaces Live Demo page you can see an example of <rich:layoutPanel> usage and sources for the given example.

The <rich:layout> chapter of the guide.

The Layout components for RichFaces 3.3.1 on the JBoss.org Wiki.