Summary
Tag name: <h:messages>
UIComponent class: javax.faces.component.html.HtmlMessages
Tag class: org.apache.myfaces.taglib.html.HtmlMessagesTag
Component type: javax.faces.HtmlMessages
Component family: javax.faces.Messages
Renderer type: javax.faces.Messages
Renderer class: org.apache.myfaces.renderkit.html.HtmlMessagesRenderer
Renders all or some FacesMessages depending on the "for" and
"globalOnly" attributes.
- If globalOnly = true, only global messages, that have no associated clientId, will be displayed.
- else if there is a "for" attribute, only messages that are assigned to the component referenced by the "for" attribute are displayed.
- else all messages are displayed.
Attributes
| Name | Type | Supports EL? | Description |
|---|---|---|---|
| binding | javax.faces.component.html.HtmlMessages | Only EL | Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind " + "to this component instance. This value must be an EL expression. |
| dir | String | Yes | HTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left). |
| errorClass | String | Yes | CSS class to be used for messages with severity "ERROR". |
| errorStyle | String | Yes | CSS style to be used for messages with severity "ERROR". |
| fatalClass | String | Yes | CSS class to be used for messages with severity "FATAL". |
| fatalStyle | String | Yes | CSS style to be used for messages with severity "FATAL". |
| for | String | Yes | The ID of the component whose attached FacesMessage object (if present) should be diplayed by this component. It takes precedence over globalOnly. |
| globalOnly | boolean | Yes | Specifies whether only messages (FacesMessage objects) not associated with a specific component should be displayed, ie whether messages should be ignored if they are attached to a particular component. Defaults to false. |
| id | String | Yes | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. |
| infoClass | String | Yes | CSS class to be used for messages with severity "INFO". |
| infoStyle | String | Yes | CSS style to be used for messages with severity "INFO". |
| lang | String | Yes | HTML: The base language of this document. |
| layout | String | Yes | The layout: "table" or "list". Default: list |
| rendered | boolean | Yes | A boolean value that indicates whether this component should be rendered. Default value: true. |
| showDetail | boolean | Yes | Specifies whether the detailed information from the message should be shown. Default to false. |
| showSummary | boolean | Yes | Specifies whether the summary information from the message should be shown. Defaults to true. |
| style | String | Yes | HTML: CSS styling instructions. |
| styleClass | String | Yes | The CSS class for this element. Corresponds to the HTML 'class' attribute. |
| title | String | Yes | HTML: An advisory title for this element. Often used by the user agent as a tooltip. |
| tooltip | boolean | Yes | If true, the message summary will be rendered as a tooltip (i.e. HTML title attribute). |
| warnClass | String | Yes | CSS class to be used for messages with severity "WARN". |
| warnStyle | String | Yes | CSS style to be used for messages with severity "WARN". |