h
Tag message


<p>Render a single message for a specific component.</p><p>Set-up for Rendering</p><ul><p>Obtain the "summary" and "detail" properties from<code>UIMessage</code> component. If not present, keep the empty string as the value, respectively. Obtain the first<code>FacesMessage</code> to render from the component, using the "for" property of the <code>UIMessage</code>. This will be the only message we render. Obtain the severity style for this message. If the severity of the message is<code>FacesMessage.SEVERITY_INFO</code>, the severity style comes from the value of the "infoStyle" attribute. If the severity of the message is<code>FacesMessage.SEVERITY_WARN</code>, the severity style comes from the value of the "warnStyle" attribute, and so on for each of the severities, <code>INFO, WARN, ERROR</code> and<code>FATAL</code>. The same rules apply for obtaining the severity style class, but instead of "infoStyle, warnStyle", etc use "infoClass, warnClass", etc. Obtain the "style", "styleClass" and "layout" attributes from the<code>UIMessage</code> component. If we have a "style" attribute and a severity style attribute, use the severity style attribute as the value of the "style" attribute. If we have no "style" attribute, but do have a severity style, use the severity style as the value of the "style" attribute. The same precedence rules apply for the style class.</p></ul><p>Rendering</p><ul><p>For the message renderer, we only render one row, for the first message. For the messages renderer, we render as many rows as we have messages. If either of the "style" or "styleClass" attributes has a non-null value (as determined above), render a "span" element, outputting the value of the "style" attribute as the the value of the "style" attribute, and outputting the value of the "styleClass" attribute as the value of the "class" attribute on the "span" element. If the<code>UIMessage</code> has a "tooltip" attribute with the value of "true", and the <code>UIMessage</code> has "showSummary" and "showDetail" properties with the value "true", if we haven't already written out the "span", output the "summary" as the value of the "title" attribute on the "span". If we haven't already written out a "title" attribute, and "showSummary" is true, output the summary. If "showDetail" is true, output the detail. Close out the span if necessary.</p></ul>


Tag Information
Tag Classcom.sun.faces.taglib.html_basic.MessageTag
TagExtraInfo Classcom.sun.faces.taglib.FacesTagExtraInfo
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
fortruefalsejava.lang.String Client identifier of the component for which to display messages.
idfalsefalsejava.lang.String The component identifier for this component. This value must be unique within the closest parent component that is a naming container.
renderedfalsefalsejava.lang.String Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit.
showDetailfalsefalsejava.lang.String Flag indicating whether the summary portion of displayed messages should be included. Default value is "true".
showSummaryfalsefalsejava.lang.String Flag indicating whether the summary portion of displayed messages should be included. Default value is "false".
errorClassfalsefalsejava.lang.String CSS style class to apply to any message with a severity class of "ERROR".
errorStylefalsefalsejava.lang.String CSS style(s) to apply to any message with a severity class of "ERROR".
fatalClassfalsefalsejava.lang.String CSS style class to apply to any message with a severity class of "FATAL".
fatalStylefalsefalsejava.lang.String CSS style(s) to apply to any message with a severity class of "FATAL".
infoClassfalsefalsejava.lang.String CSS style class to apply to any message with a severity class of "INFO".
infoStylefalsefalsejava.lang.String CSS style(s) to apply to any message with a severity class of "INFO".
stylefalsefalsejava.lang.String CSS style(s) to be applied when this component is rendered.
styleClassfalsefalsejava.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.
titlefalsefalsejava.lang.String Advisory title information about markup elements generated for this component.
tooltipfalsefalsejava.lang.String Flag indicating whether the detail portion of the message should be displayed as a tooltip.
warnClassfalsefalsejava.lang.String CSS style class to apply to any message with a severity class of "WARN".
warnStylefalsefalsejava.lang.String CSS style(s) to apply to any message with a severity class of "WARN".
bindingfalsefalsejava.lang.String The value binding expression linking this component to a property in a backing bean

Variables
No Variables Defined.


Output Generated by TLDDoc, a Sun Microsystems, Inc. CoolStuff project. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-3 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.