6.10.18. < rich:toolBarGroup > 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.18. < rich:toolBarGroup > available since 3.0.0

expand all

#### 6.10.18.1. Description

A group of items inside a tool bar.

Figure 6.111. <rich:toolbarGroup> with items on it

#### 6.10.18.2. Key Features

- Fully skinnable with its child items

- Grouping bar content

- Easily place content on either side of tool bar using a predefined group layout

- Predefined separators for menu items and groups

- Any content inside

#### 6.10.18.3. Details of Usage

A toolBarGroup is a wrapper component that groups toolBar content and facilitates creation of menu and tool bars. All components defined inside are located on a stylized bar with a possibility to group, arrange on the both bar sides, and place predefined separators between them.

Separators are located between components with the help of the "itemSeparator" attribute with four predefined values:

- "none"

- "line"

- "square"

- "disc"

To control the group location inside, use the "location" attribute with "left" (DEFAULT) and "right" values.

Example:

    ...

    <rich:toolBar itemSeparator="disc" width="500">

            <rich:toolBarGroup itemSeparator="line">

                    <h:commandLink value="Command 1.1"/>

                    <h:commandLink value="Command 2.1"/>

            </rich:toolBarGroup>

            <rich:toolBarGroup itemSeparator="line" location="right">

                    <h:commandLink value="Command 1.2"/>

                    <h:commandLink value="Command 2.2"/>

            </rich:toolBarGroup>

    </rich:toolBar>

    ...

The code result is the following:

Figure 6.112. Stylized <rich:toolbarGroup> with "location" , "itemSeparator" attributes

#### 6.10.18.4. Reference Data

Table of <rich:toolBarGroup> attributes.

Table 6.157. Component Identification Parameters

Name | Value
--- | ---
component-type | org.richfaces.ToolBarGroup
component-class | org.richfaces.component.html.HtmlToolBarGroup
component-family | org.richfaces.ToolBarGroup
renderer-type | org.richfaces.ToolBarGroupRenderer
tag-class | org.richfaces.taglib.ToolBarGroupTag

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

#### 6.10.18.5. Relevant Resources Links

Some additional information about usage of component can be found on the component Live Demo page.

- Prev6.10.17. < rich:toolBar > ...
- Top of page
- Front page
- Next6.10.19. < rich:toolTip > ...