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.

<rich:menuSeparator> component

Figure 6.86.  <rich:menuSeparator> component


Table 6.185. rich : menuSeparator attributes

Attribute NameDescription
bindingThe attribute takes a value-binding expression for a component property of a backing bean
idEvery component may have a unique id that is automatically created if omitted
renderedIf "false", this component is not rendered

Table 6.186. Component identification parameters

NameValue
component-typeorg.richfaces.MenuSeparator
component-classorg.richfaces.component.html.HtmlMenuSeparator
component-familyorg.richfaces.DropDownMenu
renderer-typeorg.richfaces.MenuSeparatorRenderer
tag-classorg.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 parametersCSS properties
panelBorderColorborder-top-color

6.48.6. Definition of Custom Style Classes

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

Classes names

Figure 6.87. Classes names


Table 6.188. Classes names that define separator element appearance.

Class nameDescription
rich-menu-separatorDefines styles for a wrapper <div> element for a separator

In order to redefine styles for all <rich:separator> components on a page using CSS, it's enough to create class with the same name and define necessary properties in it.

To change styles of particular <rich:separator> components, define your own style class in the corresponding <rich:separator> attributes.

6.48.7. Relevant Resources Links

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