15.5. <rich:notifyMessage>

15.5.1. Basic usage

The <rich:notifyMessage> component is built on top of <rich:notify>, the difference is in usage. The <rich:notifyMessage> component displays FacesMessages associated with a given component, similar to <rich:message>: one notification is displayed for first FacesMessage in the stack that is risen either programatically or during conversion/validation of the component. The severity of the message determines the color and icon of the resulting notification.
For customization of notification behavior, please refer to Customizing notifications of <rich:notify>.

15.5.2. Reference data

  • component-type: org.richfaces.NotifyMessage
  • component-class: org.richfaces.component.html.HtmlNotifyMessage
  • component-family: javax.faces.Message
  • renderer-type: org.richfaces.NotifyMessageRenderer

15.5.3. Style classes and skin parameters

Note that <rich:notifyMessage> shares common classes with <rich:notify>, since there is exactly one notification rendered for each JSF message.
The <rich:notifyMessage> specific classes are redefining the look for various message severity levels.

Table 15.4. Style classes (selectors) and corresponding skin parameters

Class (selector) Skin Parameters Mapped CSS properties
.rf-ntf-inf
This class defines styles for an informative message.
generalTextColor
color
.rf-ntf-wrn
This class defines styles for a warning notifications.
No skin parameters.
.rf-ntf-err
This class defines styles for a error notifications.
No skin parameters.
.rf-ntf-ftl
This class defines styles for a fatal notifications.
No skin parameters.
.rf-ntf-inf .rf-ntf-ico, .rf-ntf-wrn .rf-ntf-ico, .rf-ntf-err .rf-ntf-ico, .rf-ntf-ftl .rf-ntf-ico
These classes define style for notification icon based on severity of notification message.
No skin parameters.