t
Tag messages


MyFaces extension to the standard messages tag: see showInputLabel attribute. Unless otherwise specified, all attributes accept static values or EL expressions.


Tag Information
Tag Classorg.apache.myfaces.taglib.html.ext.HtmlMessagesTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
idfalsefalsejava.lang.StringThe developer-assigned ID of this component. The ID must be unique within the scope of the tag's enclosing naming container (e.g. h:form or f:subview). This value must be a static value.
bindingfalsefalsejava.lang.StringIdentifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.
renderedfalsefalsejava.lang.StringA boolean value that indicates whether this component should be rendered. Default value: true.
showSummaryfalsefalsejava.lang.StringA boolean value that controls whether the summary text of the associated messages is displayed. Default: true.
showDetailfalsefalsejava.lang.StringA boolean value that controls whether the detail text of the associated messages is displayed. Default: false.
globalOnlyfalsefalsejava.lang.StringA boolean value that controls whether global messages (those without IDs) should be displayed. Default: true.
dirfalsefalsejava.lang.StringHTML: The direction of text display, either 'ltr' (left-to-right) or 'rtl' (right-to-left).
langfalsefalsejava.lang.StringHTML: The base language of this document.
stylefalsefalsejava.lang.StringHTML: CSS styling instructions.
titlefalsefalsejava.lang.StringHTML: An advisory title for this element. Often used by the user agent as a tooltip.
styleClassfalsefalsejava.lang.StringThe CSS class for this element. Corresponds to the HTML 'class' attribute.
onclickfalsefalsejava.lang.StringHTML: Script to be invoked when the element is clicked.
ondblclickfalsefalsejava.lang.StringHTML: Script to be invoked when the element is double-clicked.
onmousedownfalsefalsejava.lang.StringHTML: Script to be invoked when the pointing device is pressed over this element.
onmouseupfalsefalsejava.lang.StringHTML: Script to be invoked when the pointing device is released over this element.
onmouseoverfalsefalsejava.lang.StringHTML: Script to be invoked when the pointing device is moved into this element.
onmousemovefalsefalsejava.lang.StringHTML: Script to be invoked when the pointing device is moved while it is in this element.
onmouseoutfalsefalsejava.lang.StringHTML: Script to be invoked when the pointing device is moves out of this element.
onkeypressfalsefalsejava.lang.StringHTML: Script to be invoked when a key is pressed over this element.
onkeydownfalsefalsejava.lang.StringHTML: Script to be invoked when a key is pressed down over this element.
onkeyupfalsefalsejava.lang.StringHTML: Script to be invoked when a key is released over this element.
infoClassfalsefalsejava.lang.StringCSS class to be used for messages with severity "INFO".
infoStylefalsefalsejava.lang.StringCSS style to be used for messages with severity "INFO".
warnClassfalsefalsejava.lang.StringCSS class to be used for messages with severity "WARN".
warnStylefalsefalsejava.lang.StringCSS style to be used for messages with severity "WARN".
errorClassfalsefalsejava.lang.StringCSS class to be used for messages with severity "ERROR".
errorStylefalsefalsejava.lang.StringCSS style to be used for messages with severity "ERROR".
fatalClassfalsefalsejava.lang.StringCSS class to be used for messages with severity "FATAL".
fatalStylefalsefalsejava.lang.StringCSS style to be used for messages with severity "FATAL".
layoutfalsefalsejava.lang.StringThe layout: "table" or "list". Default: list
tooltipfalsefalsejava.lang.StringIf true, the message summary will be rendered as a tooltip (i.e. HTML title attribute).
enabledOnUserRolefalsefalsejava.lang.StringIf user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered.
visibleOnUserRolefalsefalsejava.lang.StringIf 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.
forceIdfalsefalsejava.lang.StringIf true, this component will force the use of the specified id when rendering.
forceIdIndexfalsefalsejava.lang.StringIf false, this component will not append a '[n]' suffix (where 'n' is the row index) to components that are contained within a "list." This value will be true by default and the value will be ignored if the value of forceId is false (or not specified.)
summaryFormatfalsefalsejava.lang.StringIf present, instead of rendering the message summary, a MessageFormat with this attribute as pattern is created. The format method of this MessageFormat is called with the message summary as the first argument and the label of the associated component (if any) as the second argument. Example: "{0}:" or "{0} in field {1}"
globalSummaryFormatfalsefalsejava.lang.StringLike summaryFormat, but applies to global messages (i.e. messages not associated with a component). If no globalSummaryFormat is given, the summaryFormat is used for global messages. Example: "{0}:"
detailFormatfalsefalsejava.lang.StringIf present, instead of rendering the message detail, a MessageFormat with this attribute as pattern is created. The format method of this MessageFormat is called with the message detail as the first argument and the label of the associated component (if any) as the second argument. Example: "The input in field {1} is wrong: {0}"
replaceIdWithLabelfalsefalsejava.lang.StringIf present, all occurrences of the id of the component for which the message is rendered will be replaced by the label.
forceSpanfalsefalsejava.lang.StringIf set to true, an empty span element is rendered. Useful if there are a few inputAjax fields on the same page and the corresponding error messages should be shown on one central place.

Variables
No Variables Defined.


Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.