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.
Highly customizable look and feel
Track both traditional and Ajax based requests
Optional ToolTip to display a detailed part of the messages
Additionally customizable via attributes and facets
Additionally provides of three parts to be optionally defined: marker, label and header
The <rich:messages> component is considered as JSF HTML <h:messages> , extended with following features:
Ajax support (the component does not require to be wrapped in <a4j:outputPanel> in order to be rendered during Ajax requests);
possibilty to add graphical markers (pictograms) to reinforce a message for both "passed" or "failed" states;
set of predefined CSS classes for customizing messages appearance.
There are two optional parts that could be defined for every message: marker and text label. The set of facets, which can be used for a marker definition, is shown below:
Table 6.273. Facets
| Facet | Description |
|---|---|
| errorMarker | Defines marker for "Error" message severity class |
| fatalMarker | Defines marker for "Fatal" message severity class |
| infoMarker | Defines marker for "Info" message severity class |
| warnMarker | Defines marker for "Warn" message severity class |
The following example shows different variants of customization of the component.
Example:
<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.274. 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.renderkit.html.HtmlRichMessagesRendere |
| tag-class | org.richfaces.taglib.RichMessagesTag |
Table 6.275. Facets
| Facet | Description |
|---|---|
| errorMarker | Defines marker for "Error" message severity class |
| fatalMarker | Defines marker for "Fatal" message severity class |
| infoMarker | Defines marker for "Info" message severity class |
| warnMarker | Defines marker for "Warn" message severity class |
Table 6.276. 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 |
On the component LiveDemo page you can see the example of <rich:messages> usage and sources for the given example.
