6.14.7. <rich:message> 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.7. <rich:message> available since 3.1.0

expand all

#### 6.14.7.1. Description

The component is used for rendering a single message for a specific component.

Figure 6.185. <rich:message> component

#### 6.14.7.2. Key Features

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

- 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.7.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 <rich:message> appears on page after form is submitted. Even for "passed" state. The "passedLabel" attribute is used for definition of the label when validation is passed. Boolean attribute "showSummary" defines possibility to display summary portion of displayed messages.

    <rich:message for="id" passedLabel="No errors" showSummary="true">

          <f:facet name="errorMarker">

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

          </f:facet>

          <f:facet name="passedMarker">

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

          </f:facet>

    </rich:message>

#### 6.14.7.4. Reference Data

Table of <rich:message> attributes.

Table 6.254. Component Identification Parameters

Name | Value
--- | ---
component-type | org.richfaces.component.RichMessage
component-class | org.richfaces.component.html.HtmlRichMessage
component-family | org.richfaces.component.RichMessage
renderer-type | org.richfaces.RichMessageRenderer
tag-class | org.richfaces.taglib.RichMessageTag

Table 6.255. 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.256. Classes names that define a component appearance

Class name | Description
--- | ---
rich-message | Defines styles for a wrapper element
rich-message-marker | Defines styles for a marker
rich-message-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.7.5. Relevant Resources Links

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

- Prev6.14.6. < rich:insert > avai...
- Top of page
- Front page
- Next6.14.8. <rich:messages> available sinc...