Developing Web 2.0 applications
with JavaServerFaces
and Dreamweaver
>> Just Became Easier
Documentation
Search
  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
  12. JSF Tag Reference
JSF HTML Tag Library
  h:body
  h:button
  h:column
  h:commandButton
  h:commandLink
  h:dataTable
  h:form
  h:graphicImage
  h:head
  h:inputHidden
  h:inputSecret
  h:inputText
  h:inputTextarea
  h:link
Selected h:message
  h:messages
  h:outputFormat
  h:outputLabel
  h:outputLink
  h:outputScript
  h:outputStylesheet
  h:outputText
  h:panelGrid
  h:panelGroup
  h:selectBooleanCheckbox
  h:selectManyCheckbox
  h:selectManyListbox
  h:selectManyMenu
  h:selectOneListbox
  h:selectOneMenu
  h:selectOneRadio
If you like this documentation, please take a look at my book:

12. JSF HTML Tag Reference

Documentation > JSF > JSF Tag Reference > JSF HTML Tag Library > h:message

h:message

The message tag renders a message for a specific component. You can customize the message generated by this component by applying different CSS styles to the message depending on its severity (eg. red for error, green for information) as well as the detail level of the message itself. You can also customize the standard error messages by overriding specific JSF properties in your message bundle.

JSF Example

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" 
      xmlns:h="http://java.sun.com/jsf/html">
<h:head />
<body>
<h:form>
	<h:message errorStyle="color:red; display:block" for="myInput" />
	<h:inputText id="myInput" required="true" label="My Input" />
	<h:commandButton value="Click" />
</h:form>
</body>
</html>
This example was formatted by JSFToolbox for Dreamweaver.

Rendered Output

Rendered h:message tag

HTML Output

<form method="post" action="..." enctype="application/x-www-form-urlencoded">
  <span style="color:red; display:block">My Input: Validation Error: Value is required.</span>
  <input type="submit" name="j_idt5:j_idt7" value="Click" />
</form>

Tag Attributes

binding Expression
 
The value-binding expression linking this component tag to a backing bean property.
dir Enumerated
 
The dir attribute is a standard HTML attribute that overrides the default text directionality for this component. The values accepted for this component are "LTR" (left-to-right) and "RTL" (right-to-left).

This attribute accepts the following values:

  • LTR
  • RTL
errorClass Text
 
The errorClass attribute sets the CSS style class to apply to a message with a severity level of "ERROR".
errorStyle Text
 
The errorStyle attribute sets the CSS style or styles to apply to a message with a severity level of "ERROR".
fatalClass Text
 
The fatalClass attribute sets the CSS style class to apply to a message with a severity level of "FATAL".
fatalStyle Text
 
The fatalStyle attribute sets the CSS style or styles to apply to a message with a severity level of "FATAL".
for Text
Required
The for attribute is required and expects the component identifier of another component for which it should display a message.
id Text
 
The unique identifier value for this component. The value must be unique within the closest naming container.
infoClass Text
 
The infoClass attribute sets the CSS style class to apply to a message with a severity level of "INFO".
infoStyle Text
 
The infoStyle attribute sets the CSS style or styles to apply to a message with a severity level of "INFO".
lang Text
 
The lang attribute is a standard HTML attribute that sets the code describing the language to be used in the markup generated by this component.
rendered Boolean
 
A value-binding expression that evaluates to a Boolean condition indicating if this component should be rendered.
showDetail Boolean
 
The showDetail attribute is a boolean flag indicating whether the detail part of the message should be included. The default value is "true".
showSummary Boolean
 
The showSummary attribute is a boolean flag indicating whether the summary part of the message should be included. The default value is "false".
style Text
 
The style attribute sets the CSS style definition to be applied to this component when it is rendered.
styleClass Text
 
The styleClass attribute sets the CSS class to apply to this component when it is rendered.
title Text
 
The title attribute is a standard HTML attribute that sets the tooltip text to display for the rendered component.
tooltip Text
 
The tooltip attribute is a boolean flag indicating whether the detail part of the message should be displayed as a tooltip.
warnClass Text
 
The warnClass attribute sets the CSS style class to apply to a message with a severity level of "WARN".
warnStyle Text
 
The warnStyle attribute sets the CSS style or styles to apply to a message with a severity level of "WARN".