| |||||||
FRAMES NO FRAMES |
Render a single message for a specific component.
Set-up for Rendering
Obtain the "summary" and "detail" properties from UIMessage
component. If not present, keep the empty string as the value, respectively. Obtain the first FacesMessage
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 is FacesMessage.SEVERITY_INFO
, the severity style comes from the value of the "infoStyle" attribute. If the severity of the message is FacesMessage.SEVERITY_WARN
, the severity style comes from the value of the "warnStyle" attribute, and so on for each of the severities, INFO, WARN, ERROR
and FATAL
. 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 UIMessage
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.
Rendering
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 UIMessage
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.
Tag Information | |
Tag Class | com.icesoft.faces.component.MessageTag |
TagExtraInfo Class | None |
Body Content | JSP |
Display Name | None |
Attributes | ||||
Name | Required | Request-time | Type | Description |
binding | false | false | java.lang.String | The value binding expression linking this component to a property in a backing bean |
dir | false | false | java.lang.String | Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left). |
effect | false | false | java.lang.String | The Javascript Effect |
errorClass | false | false | java.lang.String | CSS style class to apply to any message with a severity class of "ERROR". The default class rendered as iceMsgError. |
errorStyle | false | false | java.lang.String | CSS style(s) to apply to any message with a severity class of "ERROR". |
escape | false | false | java.lang.String | Flag indicating whether the message text should be escaped or not (e.g. for including HTML tags in the message). |
fatalClass | false | false | java.lang.String | CSS style class to apply to any message with a severity class of "FATAL". The default class rendered as iceMsgFatal. |
fatalStyle | false | false | java.lang.String | CSS style(s) to apply to any message with a severity class of "FATAL". |
for | false | 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. |
infoClass | false | false | java.lang.String | CSS style class to apply to any message with a severity class of "INFO". The default class rendered as iceMsgInfo. |
infoStyle | false | false | java.lang.String | CSS style(s) to apply to any message with a severity class of "INFO". |
lang | false | false | java.lang.String | Code describing the language used in the generated markup for this component. |
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. |
renderedOnUserRole | false | false | java.lang.String | If user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped. |
showDetail | false | false | java.lang.String | Flag indicating whether the detail 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". |
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. |
visible | false | false | java.lang.String | Set the visibility of this component. When false CSS style is set to display:none |
warnClass | false | false | java.lang.String | CSS style class to apply to any message with a severity class of "WARN". The default class rendered as iceMsgWarn. |
warnStyle | false | false | java.lang.String | CSS style(s) to apply to any message with a severity class of "WARN". |
Variables | No Variables Defined. |
| |||||||
FRAMES NO FRAMES |