Documentation
JSFToolbox

Search 

Contents

  1. Introduction
  2. Getting Started
  3. Developing Web Sites
  4. Using Components
  5. Internationalization
  6. Code View Support
  7. Design View Support
  8. Keyboard Shortcuts
  9. Tag Object Toolbars
  10. JSF Server Behaviors
  11. Property Inspectors
Selected 12. JSF Tag Reference

12. JSF Tag Reference

Contents > JSF Tag Reference > JSF HTML Tags

10. JSF HTML Tag Reference

Contents > JSF HTML Tag Reference > h:messages

h:messages

The messages tag renders all message for the current view. You can customize the messages generated by this component by applying different CSS styles depending on the severity level of the messages (eg. red for error, green for information) as well as changing the detail level of the messages.

The messages tag supports two layouts for the generated messages: an HTML table or a bulleted list. The default layout is the list format. You can also customize the standard error messages by overriding specific JSF properties in your message bundle.

Example:

<h:form id="form">
  <h:inputText id="username" required="#{true}" value="#{userBean.user.username}" /><br />
  <h:inputSecret id="password" required="#{true}" value="#{userBean.user.password}" /><br />
  <h:commandButton id="submit" /><br />
  <h:messages showDetail="#{true}" showSummary="#{false}" />
</h:form>

HTML Output

<form id="form" name="form" method="post" action="/demo/messages.jsp" enctype="application/x-www-form-urlencoded">
  <input id="form:username" name="form:username" type="text" value=""/><br/>
  <input id="form:password" name="form:password" type="password" /><br/>
  <input id="form:submit" name="form:submit" type="submit" onclick="generatedCode();"/><br/>
  <ul> 
    <li>"username": Value is required.</li>
    <li>"password": Value is required.</li>
  </ul>
</form>

The above example demonstrates the result of submitting a form containing two required fields that were intentionally left blank. The resulting messages were generated by the messages tag.

Tag Attributes

binding String
 
The value-binding expression linking this component tag to a backing bean property.
errorClass String
 
The errorClass attribute sets the CSS style class to apply to a message with a severity level of "ERROR".
errorStyle String
 
The errorStyle attribute sets the CSS style or styles to apply to a message with a severity level of "ERROR".
fatalClass String
 
The fatalClass attribute sets the CSS style class to apply to a message with a severity level of "FATAL".
fatalStyle String
 
The fatalStyle attribute sets the CSS style or styles to apply to a message with a severity level of "FATAL".
globalOnly String
 
The globalOnly attribute is a boolean flag that indicates whether or not to display only global messages that are not associated with any specific components. The default value is "false".
id String
 
The unique identifier value for this component. The value must be unique within the closest naming container.
infoClass String
 
The infoClass attribute sets the CSS style class to apply to a message with a severity level of "INFO".
infoStyle String
 
The infoStyle attribute sets the CSS style or styles to apply to a message with a severity level of "INFO".
layout String
 
The layout attribute sets the layout to use for displaying messages. The valid values for this attribute are "table" and "list". The table layout uses an HTML table to display messages, while the list layout uses a bulleted list. The default value is "list".
rendered String
 
A value-binding expression that evaluates to a Boolean condition indicating if this component should be rendered.
showDetail String
 
The showDetail attribute is a boolean flag indicating whether the detail part of the message should be included. The default value is "true".
showSummary String
 
The showSummary attribute is a boolean flag indicating whether the summary part of the message should be included. The default value is "false".
style String
 
The style attribute sets the CSS style definition to be applied to this component when it is rendered.
styleClass String
 
The styleClass attribute sets the CSS class to apply to this component when it is rendered.
title String
 
The title attribute is a standard HTML attribute that sets the tooltip text to display for the rendered component.
tooltip String
 
The tooltip attribute is a boolean flag indicating whether the detail part of the message should be displayed as a tooltip.
warnClass String
 
The warnClass attribute sets the CSS style class to apply to a message with a severity level of "WARN".
warnStyle String
 
The warnStyle attribute sets the CSS style or styles to apply to a message with a severity level of "WARN".