Render a single message for a specific component.
Obtain the "summary" and "detail" properties fromUIMessage
component. If not present, keep the
empty string as the value, respectively. Obtain the firstFacesMessage
to render from the component, using
the "for" property of the UIMessage
. This will be
the only message we render. Obtain the severity style for this
message. If the severity of the message isFacesMessage.SEVERITY_INFO
, the severity style
comes from the value of the "infoStyle" attribute. If the
severity of the message isFacesMessage.SEVERITY_WARN
, the severity style
comes from the value of the "warnStyle" attribute, and so on for
each of the severities, INFO, WARN, ERROR
andFATAL
. 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 theUIMessage
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.
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 theUIMessage
has a "tooltip" attribute with the value of
"true", and the UIMessage
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.
Attributes |
Name | Required | Request-time | Type | Description |
for | true | false | java.lang.String |
Client identifier of the component for which to display messages.
|
id | false | false | java.lang.String |
The component identifier for this component. This value must be
unique within the closest parent component that is a naming
container.
|
rendered | false | false | java.lang.String |
Flag indicating whether or not this component should be rendered
(during Render Response Phase), or processed on any subsequent
form submit.
|
showDetail | false | false | java.lang.String |
Flag indicating whether the summary portion of displayed messages
should be included. Default value is "true".
|
showSummary | false | false | java.lang.String |
Flag indicating whether the summary portion of displayed messages
should be included. Default value is "false".
|
errorClass | false | false | java.lang.String |
CSS style class to apply to any message
with a severity class of "ERROR".
|
errorStyle | false | false | java.lang.String |
CSS style(s) to apply to any message
with a severity class of "ERROR".
|
fatalClass | false | false | java.lang.String |
CSS style class to apply to any message
with a severity class of "FATAL".
|
fatalStyle | false | false | java.lang.String |
CSS style(s) to apply to any message
with a severity class of "FATAL".
|
infoClass | false | false | java.lang.String |
CSS style class to apply to any message
with a severity class of "INFO".
|
infoStyle | false | false | java.lang.String |
CSS style(s) to apply to any message
with a severity class of "INFO".
|
style | false | false | java.lang.String |
CSS style(s) to be applied when this component is rendered.
|
styleClass | false | false | java.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.
|
title | false | false | java.lang.String |
Advisory title information about markup elements generated
for this component.
|
tooltip | false | false | java.lang.String |
Flag indicating whether the detail portion of the
message should be displayed as a tooltip.
|
warnClass | false | false | java.lang.String |
CSS style class to apply to any message
with a severity class of "WARN".
|
warnStyle | false | false | java.lang.String |
CSS style(s) to apply to any message
with a severity class of "WARN".
|
binding | false | false | java.lang.String |
The value binding expression linking this component to a property in a backing bean
|