6.14.8. <rich:messages> available since 3.1.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.14.8. <rich:messages> available since 3.1.0

expand all

#### 6.14.8.1. Description

The <rich:messages> component is similar to <rich:message> component but used for rendering all messages for the components.

Figure 6.186. <rich:messages> component

#### 6.14.8.2. Key Features

- Consists of three parts to be defined optionally: marker (pictogram), label (text message) and header

- Provides set of facets for marker customization

- Supports tooltip to display extra portion of message

- Tracks both traditional and Ajax requests

- Customizable look and feel

#### 6.14.8.3. Details of Usage

The component has the same behavior as standard <h:message> component. Besides some extra features:

- auto rerendering after Ajax request without help of <a4j:outputPanel>;

- providing `passed` message after validation has been passed (optional);

- possibility to add marker to a message;

- set of predefined CSS classes for customizing messages appearance.

The following example shows different variants of customization of the component.

    <rich:messages layout="table" tooltip="true" showDetail="false" showSummary="true">

          <f:facet name="errorMarker">

                <h:graphicImage url="/image/error.png"/>

          </f:facet>

          <f:facet name="infoMarker">

                <h:graphicImage url="/image/info.png"/>

          </f:facet>

     </rich:messages>

The <rich:messages> component keeps all messages for all components even after only one Ajax-validated component was updated.

#### 6.14.8.4. Reference Data

Table of <rich:messages> attributes.

Table 6.257. Component Identification Parameters

Name | Value
--- | ---
component-type | org.richfaces.component.RichMessages
component-class | org.richfaces.component.html.HtmlRichMessages
component-family | org.richfaces.component.RichMessages
renderer-type | org.richfaces.RichMessagesRenderer
tag-class | org.richfaces.taglib.RichMessagesTag

Table 6.258. Facets

Facet | Description
--- | ---
errorMarker | Defines pictogram for message with error severity class
fatalMarker | Defines pictogram for message with fatal severity class
infoMarker | Defines pictogram for message with info severity class
passedMarker | Defines pictogram if there is no fatal, error, warn or info message
warnMarker | Defines pictogram for message with warn severity class

Table 6.259. Classes names that define a component appearance

Class name | Description
--- | ---
rich-messages | Defines styles for a wrapper element
rich-messages-marker | Defines styles for a marker
rich-messages-label | Defines styles for a label

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

#### 6.14.8.5. Relevant Resources Links

Visit the Messages page at RichFaces LiveDemo for examples of component usage and their sources.

- Prev6.14.7. <rich:message> available since...
- Top of page
- Front page
- Next6.14.9. < rich:jQuery > avai...