Create new RichFaces Documentation Jira issue
This will launch the RichFaces Jira page - to complete your feedback please login if needed, and submit the Jira.
JBoss.orgCommunity Documentation
The <rich:messages> component is similar to <rich:message> component but used for rendering all messages for the components.
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
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.
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 |
Visit the Messages page at RichFaces LiveDemo for examples of component usage and their sources.
