### 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.8. < rich:panelMenuItem > available since 3.1.0

expand all

#### 6.10.8.1. Description

The <rich:panelMenuItem> component is used to define a single item inside popup list.

Figure 6.90. <rich:panelMenuItem> component

#### 6.10.8.2. Key Features

- Highly customizable look-and-feel

- Different submission modes

- Optionally supports any content inside

- Custom and predefined icons supported

- Support for disabling

#### 6.10.8.3. Details of Usage

All attributes except "label" are optional. The "label" attribute defines text to be represented.

The "mode" attribute could be used with three possible parameters:

- `Server` (default)

Regular form submission request is used.

- `Ajax`

Ajax submission is used for switching.

- `None`

"Action" and "actionListener" attributes are ignored. Items don't fire any submits itself. Behavior is fully defined by the components nested into items.

Here is an example for value "none":

Example:

    ...

    <rich:panelMenu>

            ...

           <rich:panelMenuItem mode="none" onclick="document.location.href='http://labs.jboss.com/jbossrichfaces/">

                    <h:outputLink value="http://labs.jboss.com/jbossrichfaces/">

                        <h:outputText value="RichFaces Home Page"></h:outputText>

                    </h:outputLink>

            </rich:panelMenuItem>

            ...

    </rich:panelMenu>

    ...

There are two icon-related attributes. The "icon" attribute defines an icon. The "iconDisabled" attribute defines an icon for a disabled item.

Default icons are shown on the picture below:

Figure 6.91. Default icons

Here is an example:

Example:

    ...

          <rich:panelMenu>

                ...

                <rich:panelMenuItem value="Item 1.1" icon="chevronUp" />

                ...

          </rich:panelMenu>

    ...

As the result the picture is shown below:

Figure 6.92. Using an "icon" attribute

It's also possible to define a path to the icon. Simple code is placed below.

    ...

    <rich:panelMenu>

            ...

            <rich:panelMenuItem value="Item 1.1" icon="\images\img1.png" />

            ...

    </rich:panelMenu>

    ...

Information about the "process" attribute usage you can find in the "Decide what to process" guide section.

#### 6.10.8.4. Reference Data

Table of <rich:panelMenuItem> attributes.

Table 6.129. Component Identification Parameters

Name | Value
--- | ---
component-type | org.richfaces.PanelMenuItem
component-class | org.richfaces.component.html.HtmlPanelMenuItem
component-family | org.richfaces.PanelMenuItem
renderer-type | org.richfaces.PanelMenuItemRenderer
tag-class | org.richfaces.taglib.PanelMenuItemTag

Table 6.130. Classes names that define the first level items

Class name | Description
--- | ---
rich-pmenu-top-item | Defines styles for a top panel menu item
rich-pmenu-top-item-icon | Defines styles for a top panel menu item icon
rich-pmenu-top-item-label | Defines styles for a top panel menu item label

Table 6.131. Classes names that define the second and lower level items

Class name | Description
--- | ---
rich-pmenu-item | Defines styles for a panel menu item
rich-pmenu-item-icon | Defines styles for a panel menu item icon
rich-pmenu-item-label | Defines styles for a panel menu item label

Table 6.132. Classes names that define items state

Class name | Description
--- | ---
rich-pmenu-item-selected | Defines styles for a panel menu selected item
rich-pmenu-disabled-element | Defines styles for a disabled panel menu item
rich-pmenu-hovered-element | Defines styles for a hovered panel menu item

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

#### 6.10.8.5. Relevant Resources Links

Some additional information about usage of component can be found on this LiveDemo page.

- Prev6.10.7. < rich:panelMenuGroup > ...
- Top of page
- Front page
- Next6.10.9. < rich:progressBar > ...