webuijsf
Tag messageGroup


Use the webuijsf:messageGroup tag to display a list of messages that are not associated with a specific component. The MessageGroup component displays error messages for all components on the page, and for the JSP page itself. Generally, the tag should be used at the top or bottom of the page.

Note that the messages displayed with the webuijsf:messageGroup tag do not indicate which component the messages are associated with. Use the webuijsf:message tag to associate error messages with specific components.

HTML Elements and Layout

A message group consists of a list of messages. The messages are listed in the order in which they are queued as the page is processed by the server. There is no indication of which component has the error. You should use the webuijsf:message tag to display error messages next to the affected components.

Configuring the webuijsf:messageGroup tag

Use the showGlobalOnly attribute to show only the messages that are not associated with a particular component. This attribute can be used to avoid redundant display of error messages which can occur if you also use the webuijsf:message tag in the same page. Use the showSummary and showDetail tag attributes to specify whether to include summary text and detailed text.

Messages are defined in a resource bundle, which can include keys for summary text and detailed text for messages.

Theme Identifiers

TBA

Client Side Javascript Functions

None.

Examples

Example 1: Display global errors at the top of the page

This example shows where you might position the webuijsf:messageGroup tag to display errors at the top of the page. The example uses the showGlobalOnly attribute to avoid duplicating the errors displayed by the webuijsf:message tag that is included in this page.

 <webuijsf:page>
   <webuijsf:html>
    <webuijsf:head title="A title" />
      <webuijsf:body>
      <webuijsf:form ....>
      <webuijsf:masthead ... >
      <webuijsf:breadcrumbs >
      </webuijsf:breadcrumbs >
       
       <webuijsf:messageGroup showGlobalOnly="true"/>
       <webuijsf:staticText text="Validator checks that the value is between 0-10 inclusive. />
       <webuijsf:message for="form1:textTest1"/>
       <webuijsf:textField id="textTest1" label="Enter a number:" 
                        text="#{FieldTest.number}" 
                        validator="#{FieldTest.checkNumber}"/>
       ....
 


Tag Information
Tag Classcom.sun.webui.jsf.component.MessageGroupTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
bindingfalsefalsejava.lang.String A ValueExpression that resolves to the UIComponent that corresponds to this tag. This attribute allows the Java bean that contains the UIComponent to manipulate the UIComponent, its properties, and its children.
toolTipfalsefalsejava.lang.String

Sets the value of the title attribute for the HTML element. The specified text will display as a tooltip if the mouse cursor hovers over the HTML element.

styleClassfalsefalsejava.lang.String

CSS style class(es) to be applied to the outermost HTML element when this component is rendered.

titlefalsefalsejava.lang.String

Sets the title of the message group. If this attribute is not specified, the default title "System Messages" will be used.

showSummaryfalsefalsejava.lang.String

Set this attribute to true to display the summary message.

visiblefalsefalsejava.lang.String

Use the visible attribute to indicate whether the component should be viewable by the user in the rendered HTML page. If set to false, the HTML code for the component is present in the page, but the component is hidden with style attributes. By default, visible is set to true, so HTML for the component HTML is included and visible to the user. If the component is not visible, it can still be processed on subsequent form submissions because the HTML is present.

stylefalsefalsejava.lang.String

CSS style(s) to be applied to the outermost HTML element when this component is rendered.

showGlobalOnlyfalsefalsejava.lang.String

Use the showGlobalOnly attribute to display only those messages that are not associated with a component id. This attribute allows you to avoid showing a component error twice if you use webuijsf:message and webuijsf:messageGroup in the same page.

renderedfalsefalsejava.lang.String Use the rendered attribute to indicate whether the HTML code for the component should be included in the rendered HTML page. If set to false, the rendered HTML page does not include the HTML for the component. If the component is not rendered, it is also not processed on any subsequent form submission.
showDetailfalsefalsejava.lang.String

Set this attribute to true to display the detailed message.

idfalsetruejava.lang.StringNo Description

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.