JSF Implementations
UI-Component Sets
Add-ons and Extensions
Documentation
Project Documentation
Foundation

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".