# rich

## Tag notifyMessage

- Description:

    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.

    @author Lukas Fryc @author Brian Leathem

- Component Information
  Info | Value
  --- | ---
  Component Type | `org.richfaces.NotifyMessage`
  Handler Class | None
  Renderer Type | `org.richfaces.NotifyMessageRenderer`
  Description | 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. @author Lukas Fryc @author Brian Leathem

- Attributes
  Name | Required | Type | Description
  --- | --- | --- | ---
  `ajaxRendered` | `false` | `javax.el.ValueExpression` (must evaluate to `boolean`) | Defines, whether the content of this component must be (or not) included in AJAX response created by parent AJAX Container, even if it is not forced by reRender list of ajax action. Ignored if component marked to output by some Ajax action component. Default value - "true"
  `binding` | `false` | `javax.el.ValueExpression` (must evaluate to `javax.faces.component.UIComponent`) | The value binding expression used to wire up this component to a component property of a JavaBean class
  `dir` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).
  `escape` | `false` | `javax.el.ValueExpression` (must evaluate to `boolean`) | Flag indicating that characters that are sensitive in HTML and XML markup must be escaped. This flag is set to "true" by default.
  `for` | `true` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Client identifier of the component for which to display messages.
  `id` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | The component identifier for this component. This value must be unique within the closest parent component that is a naming container.
  `lang` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Code describing the language used in the generated markup for this component.
  `nonblocking` | `false` | `javax.el.ValueExpression` (must evaluate to `boolean`) | Defines whether the notification should fade when hovering and allow to click elements behind
  `nonblockingOpacity` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.Double`) | Defines opacity of non-blocking notifications
  `onclick` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a pointer button is clicked over this element.
  `ondblclick` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a pointer button is double clicked over this element.
  `onkeydown` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a key is pressed down over this element.
  `onkeypress` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a key is pressed and released over this element.
  `onkeyup` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a key is released over this element.
  `onmousedown` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a pointer button is pressed down over this element.
  `onmousemove` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a pointer button is moved within this element.
  `onmouseout` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a pointer button is moved away from this element.
  `onmouseover` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a pointer button is moved onto this element.
  `onmouseup` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Javascript code executed when a pointer button is released over this element.
  `rendered` | `false` | `javax.el.ValueExpression` (must evaluate to `boolean`) | Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.
  `showCloseButton` | `false` | `javax.el.ValueExpression` (must evaluate to `boolean`) | Defines whether the close button should be displayed
  `showDetail` | `false` | `javax.el.ValueExpression` (must evaluate to `boolean`) | Flag indicating whether the detail portion of displayed messages should be included. Default value is "true".
  `showShadow` | `false` | `javax.el.ValueExpression` (must evaluate to `boolean`) | Defines whether the shadow under notification should be displayed
  `showSummary` | `false` | `javax.el.ValueExpression` (must evaluate to `boolean`) | Flag indicating whether the summary portion of displayed messages should be included. Default value is "false".
  `stack` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines which stack will be notification bound to
  `stayTime` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.Integer`) | Defines how long will notification stay displayed after appearing
  `sticky` | `false` | `javax.el.ValueExpression` (must evaluate to `boolean`) | If true, notifications have to be closed with the close button (overrides @showCloseButton)
  `style` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS style(s) to be applied when this component is rendered.
  `styleClass` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Space-separated list of CSS style class(es) to be applied when this element is rendered. This value must be passed through as the "class" attribute on generated markup.
  `title` | `false` | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Advisory title information about markup elements generated for this component.

Output generated by Vdldoc View Declaration Language Documentation Generator.