rich:layout rich:layout

Component identification parameters

Name | Value
--- | ---
component-type | org.richfaces.layout
component-class | org.richfaces.component.html.HtmlLayout
component-family | org.richfaces.Layout
renderer-type | org.richfaces.LayoutRenderer
tag-class | org.richfaces.taglib.layoutTag

## Creating the Component with a Page Tag

To create the simplest layout with the <rich:layout> on a page, use the following syntax:

Example:

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

## Creating the Component Dynamically Using Java

Example:

    import org.richfaces.component.html.HtmlLayout;
    ...
    Htmllayout mylayout = new HtmlLayout();
    ...

## Details of Usage

The <rich:layout> allows to build a grid that can be used to make the layout on a page. The <rich:layout> is used in conjunction with the <rich:layoutPanel> that is used as a child element and carries the main burden of building the grid.

Hence, you need to use the <rich:layout> as a container and <rich:layoutPanel> to create areas inside the container.

This is how you can make a layout with 5 areas:

Example:

    ...
    <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>
    ...

To get more details about <rich:layoutPanel> please read the chapter about layoutPanel in the guide.

## Relevant Resources Links

Visit layout page at RichFaces Live Demo for examples of component usage and their sources.

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