| |||||||
FRAMES NO FRAMES |
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.
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.
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.
None.
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 Class | com.sun.webui.jsf.component.MessageGroupTag |
TagExtraInfo Class | None |
Body Content | JSP |
Display Name | None |
Attributes | ||||
Name | Required | Request-time | Type | Description |
binding | false | false | java.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. |
toolTip | false | false | java.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. |
styleClass | false | false | java.lang.String | CSS style class(es) to be applied to the outermost HTML element when this component is rendered. |
title | false | false | java.lang.String | Sets the title of the message group. If this attribute is not specified, the default title "System Messages" will be used. |
showSummary | false | false | java.lang.String | Set this attribute to true to display the summary message. |
visible | false | false | java.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. |
style | false | false | java.lang.String | CSS style(s) to be applied to the outermost HTML element when this component is rendered. |
showGlobalOnly | false | false | java.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 |
rendered | false | false | java.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. |
showDetail | false | false | java.lang.String | Set this attribute to true to display the detailed message. |
id | false | true | java.lang.String | No Description |
Variables | No Variables Defined. |
| |||||||
FRAMES NO FRAMES |