6.10.5. <rich:panelBarItem> available since 3.0.0

### 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.10.5. <rich:panelBarItem> available since 3.0.0

expand all

#### 6.10.5.1. Description

The component is designed to be used as a part of <rich:panelBar>. The <rich:panelBarItem> used separately from <rich:panelBar> will not be rendered.

Figure 6.83. The <rich:panelBar> consists of three <rich:panelBarItem> components.

#### 6.10.5.2. Key Features

- May have any content inside

- Has customizable look and feel

#### 6.10.5.3. Details of Usage

The <rich:panelBar> could contain any number of panelBarItem components. Item headers are used for collapsing and expanding item contents.

The <rich:panelBarItem> supports `label` facet that defines text label on it's header. Besides that there is "label" attribute that does the same job. By default the component is rendered with a header and text label "auto generated label". The following two entries

    <-- A -->

    <rich:panelBar>

          <rich:panelBarItem label="Olympus EVOLT E-500" />

    </rich:panelBar>

    <-- B -->

    <rich:panelBar>

          <rich:panelBarItem>

                <f:facet name="label">

                      <h:outputText value="Olympus EVOLT E-500"/>

                </f:facet>

          </rich:panelBarItem>

    </rich:panelBar>

will have the same output.

#### 6.10.5.4. Reference Data

Table of <rich:panelBarItem> attributes.

Table 6.117. Component Identification Parameters

Name | Value
--- | ---
component-type | org.richfaces.PanelBarItem
component-class | org.richfaces.component.html.HtmlPanelBarItem
component-family | org.richfaces.PanelBarItem
renderer-type | org.richfaces.PanelBarItemRenderer
tag-class | org.richfaces.taglib.PanelBarItemTag

Table 6.118. Facet

Facet name | Description
--- | ---
label | Defines text label on panel header

Table 6.119. Style classes (selectors) and mapped skin parameters

Class name | Description | Skin parameter | CSS property
--- | --- | --- | ---
.rich-panelbar-content | Defines styles for panelBar content | preferableDataFamilyFont | font-family
preferableDataSizeFont | font-size
generalTextColor | color
.rich-panelbar-header | Defines styles for panelBar header | headerBackgroundColor | background-color
headerFamilyFont | font-family
headerSizeFont | font-size
headerWeightFont | font-weight
headerTextColor | color
.rich-panelbar-header-act | Defines styles for panelBar active header | headerBackgroundColor | background-color
headerFamilyFont | font-family
headerSizeFont | font-size
headerWeightFont | font-weight
headerTextColor | color

You can find all necessary information about style classes redefinition in Definition of Custom Style Classes section.

#### 6.10.5.5. Relevant Resources Links

Visit PanelBar page at RichFaces LiveDemo for example of the <rich:panelBarItem>component usage and it source.

If you have any questions or ideas regarding the <rich:panel> tell about them at the RichFaces Users Forum.

- Prev6.10.4. < rich:panelBar > av...
- Top of page
- Front page
- Next6.10.6. <rich:panelMenu> ava...