### Create new RichFaces Documentation Jira issue

Summary
255 characters left
Description
Environment
This will launch the RichFaces Jira page - to complete your feedback please login if needed, and submit the Jira.

JBoss.org Community Documentation

- Prev
- Next

## 6.67. < rich:layout >

### 6.67.1. Description

The <rich:layout> component is designed to build layouts basing on Yahoo UI Grids CSS

Figure 6.185. The <rich:layout> component

### 6.67.2. Key Features

- Cross-borwser compatibility

- Easy layout creation

Table 6.336. rich : layout attributes

Attribute Name | Description
--- | ---
binding | The attribute takes a value-binding expression for a component property of a backing bean
id | Every component may have a unique id that is automatically created if omitted
rendered | If "false", this component is not rendered

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

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

    ...

### 6.67.4. Creating the Component Dynamically Using Java

Example:

    import org.richfaces.component.html.HtmlLayout;

    ...

    Htmllayout mylayout = new HtmlLayout();

    ...

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

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

- Prev6.66. < rich:jQuery >
- Top of page
- Front page
- Next6.68. < rich:layoutPanel >