Keywords: rich:menuSeparator

JBoss.org Community Documentation

- Prev
- Next

## 6.48. < rich:menuSeparator >

### 6.48.1. Description

The <rich:menuSeparator> component is used for the definition of a horizontal separator that can be placed between groups or items.

Figure 6.103. <rich:menuSeparator> component

Table 6.185. rich : menuSeparator 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.186. Component identification parameters

Name | Value
--- | ---
component-type | org.richfaces.MenuSeparator
component-class | org.richfaces.component.html.HtmlMenuSeparator
component-family | org.richfaces.DropDownMenu
renderer-type | org.richfaces.MenuSeparatorRenderer
tag-class | org.richfaces.taglib.MenuSeparatorTag

### 6.48.2. Creating the Component with a Page Tag

Here is a simple example as it could be used on a page:

Example:

    ...

        <rich:dropDownMenu/>

            ...

            <rich:menuSeparator/>

            ...

        <rich:dropDownMenu/>

    ...

### 6.48.3. Creating the Component Dynamically Using Java

Example:

    import org.richfaces.component.html.HtmlMenuSeparator;

    ...

    HtmlMenuSeparator myMenuSeparator = new HtmlMenuSeparator();

    ...

### 6.48.4. Look-and-Feel Customization

For skinnability implementation, the components use a style class redefinition method. Default style classes are mapped on skin parameters.

There are two ways to redefine the appearance of all <rich:menuSeparator> components at once:

- Redefine the corresponding skin parameters

- Add to your style sheets style classes used by a <rich:menuSeparator> component

### 6.48.5. Skin Parameters Redefinition

Table 6.187. Skin parameters redefinition for an item

Skin parameters | CSS properties
--- | ---
panelBorderColor | border-top-color

### 6.48.6. Definition of Custom Style Classes

On the screenshot there are classes names that define styles for component elements.

Figure 6.104. Classes names

Table 6.188. Classes names that define separator element appearance.

Class name | Description
--- | ---
rich-menu-separator | Defines styles for a wrapper <div> element for a separator

In order to redefine styles for all <rich:menuSeparator> components on a page using CSS, it's enough to create classes with the same names (possible classes could be found in the tables above) and define necessary properties in them.

Example:

    ...

    .rich-menu-separator{

            border-color: #acbece;

    }

    ...

This is a result:

Figure 6.105. Redefinition styles with predefined classes

In the example a menu separator border color was changed.

### 6.48.7. Relevant Resources Links

Here you can see the example of <rich:menuSeparator> usage and sources for the given example.

- Prev6.47. < rich:menuItem >
- Top of page
- Front page
- Next6.49. < rich:effect >